Loading / 加载中…
Loading / 加载中…
Utilities & AI data
Holiday data looked up by two-letter country code, with a separate operation that lists the supported codes. Get the holidays for a year, test whether one date is a working day, count working days between two dates, list the holidays still ahead of a reference date, or find long weekends together with suggested bridge days. Optional inputs let a caller redefine the weekend, choose which holiday type counts as a day off, and narrow results to a region.
Checking current availability and approved prices…
JSON in, a structured response out. Every public gateway endpoint uses POST.
Takes no inputs and returns the supported country codes with their names.
POST /api/v1/holidays/holidays-countriesUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {}
}Lists the holidays of one country for one year from 1900 to 2200.
POST /api/v1/holidays/holidays-holidaysUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"country": "US",
"year": 2026
}
}Tells whether one date is a working day in a country and returns the reasons alongside the answer.
POST /api/v1/holidays/holidays-is-workdayUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"country": "US",
"date": "2026-01-01"
}
}Returns the long-weekend windows of a year, each flagged with whether a bridge day is needed.
POST /api/v1/holidays/holidays-long-weekendsUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"country": "US",
"year": 2026
}
}Returns the holidays ahead of today or of a reference date you supply, with the days remaining for each.
POST /api/v1/holidays/holidays-next-holidaysUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"country": "US"
}
}Returns the working, weekend and holiday day counts between an inclusive start date and end date.
POST /api/v1/holidays/holidays-workday-countUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"country": "US",
"end": "2026-01-31",
"start": "2026-01-01"
}
}POST /api/v1/<project>/<action> with x-api-key, Content-Type: application/json and a required Idempotency-Key.data is the result of the operation.Not in one request: body.types takes a single one of the 6 listed types, spelled as listed, and when it is omitted only Public counts as a day off. To treat several types as days off, send one request per type and merge the answers date by date: a date is a working day only if every per-type response says so. Do not add up counts from separate holidays-workday-count requests. The range count returns no per-date working-day results, so a combined count needs per-date answers from holidays-is-workday (one request per date and type) or your own calculation.
Integer years from 1900 to 2200 for the yearly holiday list and the long-weekend finder; the contract rejects other values.
By default the weekend is Saturday and Sunday, and Friday and Saturday for EG and BD; body.weekend overrides this with day names.