📅

Calendar Holidays API

Get public holidays for any country and year. Supports 100+ countries. Perfect for scheduling, HR systems, and international date handling.

API Docs $0.001 / request

About this tool

Retrieve official public holidays for any country and year. Returns holiday name, local name, date, type (Public, Bank, School, etc.), and regional scope. Powered by Nager.Date, covering 100+ countries with accurate, up-to-date data.

Quick Start

Get holidays for Brazil in 2026:

curl "https://api.iteratools.com/calendar/holidays?year=2026&countryCode=BR" \ -H "Authorization: Bearer YOUR_KEY"

Get holidays for the USA:

curl "https://api.iteratools.com/calendar/holidays?year=2026&countryCode=US" \ -H "Authorization: Bearer YOUR_KEY"

Response Example

{ "year": 2026, "countryCode": "BR", "count": 12, "holidays": [ { "date": "2026-01-01", "name": "New Year's Day", "localName": "Confraternização Universal", "types": ["Public"], "global": true, "counties": null }, { "date": "2026-02-16", "name": "Carnival", "localName": "Carnaval", "types": ["Public"], "global": true, "counties": null } ] }

Parameters

Parameter Type Default Description
year integer current year Year to query (1900–2100)
countryCode string US ISO 3166-1 alpha-2 country code (e.g. US, BR, DE, FR, GB)

Details

EndpointGET /calendar/holidays
Price$0.001 / request
AuthBearer token or x402 micropayment
Countries100+ supported
Base URLhttps://api.iteratools.com
Full Documentation Browse All Tools