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	Required
country	required
year	required

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	Required
country	required
date	required
weekend	optional
types	optional
subdivision	optional

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	Required
country	required
start	required
end	required
weekend	optional
types	optional
subdivision	optional

Try in playground →

post/holidays/v1/next_holidays1 credit

upcoming public holidays (next ~365 days) with daysUntil

Parameter	Required
country	required
today	optional

Try in playground →

post/holidays/v1/long_weekends1 credit

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

Parameter	Required
country	required
year	required

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
}