Name: Calendar Holidays API
Price: 0.001 USD

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

Endpoint	GET /calendar/holidays
Price	$0.001 / request
Auth	Bearer token or x402 micropayment
Countries	100+ supported
Base URL	https://api.iteratools.com