docs / holidays

Holidays & Workdays

Public holidays and business-day calculations.

base /holidays/v16 endpoints

post/holidays/v1/holidays1 credit

public holidays for a country + year (full Nager fields + derived year/weekday/nationwide)

Parameter		Allowed / range	Description
country	required	—	2-letter ISO-3166 country code (e.g. US, GB, DE, TR, JP). 123 countries supported — call action='countries' for the full set. Case-insensitive.
year	required	1900–2200	4-digit year (supported range 1900-2200).

Try in playground →

post/holidays/v1/is_workday1 credit

is a given date a working day for a country? (weekend + public-holiday aware; reasons[] explain)

Parameter		Allowed / range	Description
country	required	—	2-letter ISO-3166 country code (e.g. US, GB, DE, TR, JP). 123 countries supported — call action='countries' for the full set. Case-insensitive.
date	required	—	The date to test, in ISO format YYYY-MM-DD.
weekend	optional	—	Override the weekend definition with day names (e.g. 'Sat,Sun' or 'Fri,Sat'). Defaults to Sat+Sun (Fri+Sat for EG/BD).
types	optional	Public · Bank · School · Authorities · Optional · Observance	Which holiday types count as a day off (comma-separated, case-insensitive). Defaults to Public only.
subdivision	optional	—	Optional ISO-3166-2 subdivision code (e.g. US-CA, GB-SCT) for region-precise business days. Omit for nationwide. Case-insensitive.

Try in playground →

post/holidays/v1/workday_count1 credit

business-day count over a date range: workdays/weekend_days/holiday_days + the holidays in range

Parameter		Allowed / range	Description
country	required	—	2-letter ISO-3166 country code (e.g. US, GB, DE, TR, JP). 123 countries supported — call action='countries' for the full set. Case-insensitive.
start	required	—	Range start date (inclusive), ISO YYYY-MM-DD.
end	required	—	Range end date (inclusive), ISO YYYY-MM-DD. Max range ~10 years.
weekend	optional	—	Override the weekend definition with day names (e.g. 'Sat,Sun' or 'Fri,Sat'). Defaults to Sat+Sun (Fri+Sat for EG/BD).
types	optional	Public · Bank · School · Authorities · Optional · Observance	Which holiday types count as a day off (comma-separated, case-insensitive). Defaults to Public only.
subdivision	optional	—	Optional ISO-3166-2 subdivision code (e.g. US-CA, GB-SCT) for region-precise business days. Omit for nationwide. Case-insensitive.

Try in playground →

post/holidays/v1/next_holidays1 credit

upcoming public holidays (next ~365 days) with daysUntil

Parameter		Allowed / range	Description
country	required	—	2-letter ISO-3166 country code (e.g. US, GB, DE, TR, JP). 123 countries supported — call action='countries' for the full set. Case-insensitive.
today	optional	—	Optional 'as of' date (ISO YYYY-MM-DD) to compute daysUntil from; defaults to the current UTC date.

Try in playground →

post/holidays/v1/long_weekends1 credit

long-weekend windows for a country + year (+ bridge-day suggestions)

Parameter		Allowed / range	Description
country	required	—	2-letter ISO-3166 country code (e.g. US, GB, DE, TR, JP). 123 countries supported — call action='countries' for the full set. Case-insensitive.
year	required	1900–2200	4-digit year (supported range 1900-2200).

Try in playground →

post/holidays/v1/countriesfree

the supported country set (code → name)

Try in playground →

Example request · holidays

curl -X POST https://api.reefapi.com/holidays/v1/holidays \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"country":"US","year":2026}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}