Public holidays API by country and year

$0.001 per call with a key ($0.01 paid per call from a wallet) · failed calls are never charged · no account needed: a card key or USDC

Public holidays for a year in over 100 countries: date, local and English name, whether it is nationwide, and the observed day where a weekend moves it. Statutory rules of our own for the US, UK, Sweden, Germany, France, Norway, Denmark and Finland (2024-2100); Nager.Date for the rest (Japan, Canada, Australia, India, Brazil…). Use for scheduling, delivery dates and business-day maths.

When to use it

List a country's public holidays for scheduling
Skip holidays when planning deliveries or meetings

Guide: Public holidays API

Run it free (3 free calls) Buy credits by card (from $1) Example result (JSON)

$0.001 per call with prepaid credits: $1 by card pays for 1,000 calls, with no account and no subscription.

Inputs

Name	Type	Description
`country` (required)	string	ISO 3166-1 alpha-2 code (US, GB, SE, JP, CA…) or English country name
`year`	integer	Year, 2024-2100 (default this year)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://glyphcall.com/holidays?country=SE"

Or one of your 3 free calls, no key:

curl "https://glyphcall.com/holidays?country=SE&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "country": "SE",
  "countryName": "Sweden",
  "year": 2026,
  "count": 13,
  "holidays": [
    {
      "date": "2026-01-01",
      "localName": "Nyårsdagen",
      "name": "New Year's Day",
      "nationwide": true,
      "types": [
        "Public"
      ],
      "observed": null
    }
  ],
  "note": "Computed from statutory rules; nationwide holidays only. Regional holidays and one-off proclamations are not included."
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is holidays, and the first 25 successful calls are free:

https://glyphcall.com/mcp

Questions

Which countries?

Countries covered by the Nager.Date public holiday data, by two-letter code.

How do I pay?

Each successful call costs $0.01; failed calls are not charged. The first 3 calls are free (25 through an MCP client). Then pay with card credits (from $1; the key goes in an Authorization header or, for clients that can only fetch a URL, as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.