Get API key

Terms of service

These terms are between you and the operator of pholidays.com.

The service

PH Holidays is a Philippine holidays website and API. The website is free to read. The API under /v1 needs a Client key. Holiday data comes from official sources (the PCO annual proclamations and the Official Gazette). It is not legal advice: verify against the proclamation.

Plans and Client keys

Plans (Pro and Business), their prices, request quotas, rate limits and features are listed on /pricing. A Plan comes with Client keys, which you create at /account.

  • A Client key is shown once. Keep it secret and do not publish it. Revoke a key you think has leaked.
  • Quotas are hard caps. Past the quota a call gets 429 with Retry-After. There is no overage billing.
  • A free Sandbox key serves date and year lookups inside 2024 only, 100 requests a day. No /v1/upcoming, no workday, no locality filter, no change feed.

Billing

Our order process is conducted by our online reseller Paddle.com. Paddle.com is the Merchant of Record for all our orders. Paddle provides all customer service inquiries and handles returns.

  • You can cancel at any time in the Paddle customer portal (linked from /account). Access continues to the end of the paid period.
  • If a payment fails, your Client keys keep working for 7 days. After that the API answers 403 until a payment succeeds. Your keys are not deleted.
  • Refunds are covered by the refund policy.

No uptime SLA, data freshness

No uptime SLA. The sources (PCO and the Official Gazette) are checked once a day. The annual PCO list is applied automatically. Amendments, mid-year proclamations and some local proclamations need a manual review. We add them within 2 business days of their publication by PCO or the Official Gazette. Every answer carries meta.lastChecked, the last successful check of the sources (not a re-check of every holiday).

Contact

Email support@pholidays.com with questions about the service or these terms.

Changes

We may change these terms and the prices. We give notice of a change before it applies to you.

See also the privacy page.