Public Holidays
Public holidays for 150+ countries, with next holiday, is-it-a-holiday checks and working-day calculations.
base https://prod.api.market/api/v1/claimcheckai/public-holidays/holidays/v1- endpoints
- 5
- free plan, paid from
- $8.50/mo
- data
- Self-contained
List public holidays for a country and year, check whether a date is a holiday, find the next one, and count or add working days.
// Is Thanksgiving 2026 a business day?
curl "https://prod.api.market/api/v1/claimcheckai/public-holidays/holidays/v1/US/check?date=2026-11-26" \
-H "x-api-market-key: $API_MARKET_KEY"{
"country": "US",
"date": "2026-11-26",
"weekday": "Thursday",
"is_holiday": true,
"holiday_name": "Thanksgiving Day",
"is_weekend": false,
"is_business_day": false
}Endpoints
List supported countries and their subdivisions
Upcoming public holidays
countrypathrequiredsubdivisionqueryfromqueryStart date, default today.
limitquery
Is a date a public holiday or a business day?
countrypathrequireddatequeryrequiredsubdivisionquery
Count or add business days
Give either `end` (to count business days in a range) or `add` (to find the date N business days away).
countrypathrequiredstartqueryrequiredendqueryCount business days from start up to and including this date.
addqueryOr: move this many business days from start.
subdivisionquery
List public holidays for a country and year
Returns nationwide public holidays, plus regional ones when a subdivision is given.
countrypathrequiredyearpathrequiredsubdivisionqueryState, province or region code, for example CA or BY.
Data and limits
source
The open-source holidays library, computed locally.
Answers from bundled data or local computation. No upstream call.
limits
- Public holidays only. Verify before relying on them for payroll or legal deadlines.
- Weekends follow each country's convention.
Plans
Monthly, in US dollars. Each plan stops at its quota, with no overage charges. Subscribe and pay on api.market.
| plan | price | calls / month | per 1k calls | |
|---|---|---|---|---|
| Free trial | Free | 100, once, for 7 days | — | start free on api.market ↗ |
| Basic | $8.50 | 10,000 | $0.85 | subscribe on api.market ↗ |
| Pro | $26 | 100,000 | $0.26 | subscribe on api.market ↗ |
| Ultra | $68 | 500,000 | $0.14 | subscribe on api.market ↗ |