What it returns
Public and bank holidays for more than 100 countries.
Date, weekday, English and local name, country, nationwide or regional, regions, types, fixed date flag.
Common uses
Scheduling and delivery-date calculators, payroll and HR tools, travel planning, marketing calendars. Pay per record.
Request
POST https://api.pushbuild.com/public-holidays/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: holidays, long-weekends, check-dates, next-worldwide | Holiday list, long weekends, check specific dates, or the next holidays worldwide (next 7 days). Default: "holidays". |
countries | list of strings | ISO 2-letter codes (US, GB, DE...) or ALL. |
years | list of strings | Years to return, e.g. 2026. Default: this year. |
startDate | string | Instead of years: from this date (YYYY-MM-DD). |
endDate | string | Up to this date (YYYY-MM-DD). |
dates | list of strings | For check-dates mode (YYYY-MM-DD). |
region | string | ISO 3166-2 subdivision, e.g. US-CA, DE-BY, GB-SCT. Keeps nationwide plus that region's holidays. |
types | list of strings | Public, Bank, School, Authorities, Optional, Observance. Empty = all. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/public-holidays/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"countries": ["US", "GB"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 records. No charge for errors or empty searches.
Related APIs
Tide Times API
Official NOAA tide predictions (high/low and hourly), observed water levels, water and air temperature, wind and pressure for 3,000+ US coastal stations.
TSA Checkpoint Travel Numbers + BTS Transportation Stats API
Daily TSA airport checkpoint passenger counts since 2019 with year-over-year and 7-day averages, plus BTS monthly transportation statistics: airline passengers, on-time performance, air cargo, freight rail, trucking, transit and the Transportation Services Index..
US Weather API
National Weather Service data for any US ZIP code, city or coordinates: 7-day forecast, hourly forecast, latest observed conditions and active severe-weather alerts.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com