Location · API
Public Holidays
Return public and bank holidays for any country and year — for scheduling, SLAs and business-day math.
GET /v1/holidays
GET /v1/holidays
200 OK
{ "country": "US", "year": 2026, "holidays": [ { "date": "2026-07-04", "name": "Independence Day", "type": "public" } ] }
Capabilities
Why teams use it
230+ countries
Public and bank holidays worldwide.
Public & bank holidays
National, regional and observance days.
Business-day math
Add or subtract working days accurately.
Regional variations
State and province-level differences.
Multi-year
Past and future years in one call.
Localized names
Holiday names in local languages.
Request
Call it in your language
curl "https://api.locanium.com/v1/holidays?country=US&year=2026" \ -H "Authorization: Bearer sk_live_..."
Response
What you get back
- ISO country code
countrystring - Year
yearnumber - Holiday date (ISO)
datestring - Holiday name
namestring - public / bank / observance
typestring
Use cases
What you can build
Location family
Full parameters, errors and code samples are in the API reference.