Public holidays API

From $0.01 per successful call · failed calls are never charged · no account needed · Markdown version: /guides/public-holidays-api.md

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 an agent wants this

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

Public holidays by country: list a country's public holidays for a year $0.01

Inputs: country (required): ISO 3166-1 alpha-2 code (US, GB, SE, JP, CA…) or English country name; year: Year, 2024-2100 (default this year).

Free first (3 successful calls per caller, no key):

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

With prepaid credits this tool costs $0.001 a call: $1 by card pays for 1,000 calls, with no account and no subscription.

With a card key from /credits, in a header or, when your client can only fetch a URL, in the URL:

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

Without a key the same URL answers 402 Payment Required with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://glyphcall.com/mcp) this tool is holidays.

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."
}

Tool page, inputs and limits

Business days between dates, working days calculator: count working days between two dates, skipping weekends and public holidays $0.01

Count business (working) days between two dates, skipping weekends and the nationwide public holidays of over 100 countries (our statutory rules for US, UK, SE, DE, FR, NO, DK, FI; Nager.Date for the rest, e.g. JP, NZ, CA, AU, IN), and list the holidays skipped; or give add=N for the date N business days after (or before) a date. Use for delivery estimates, SLAs, payment terms and payroll dates.

Inputs: from (required): Start date, YYYY-MM-DD; to: End date, YYYY-MM-DD (inclusive; default: the last day of the start month); or use add; add: Business days to add to from (negative to go back), instead of to; country: Holiday calendar: a 2-letter country code or English name, e.g. SE, JP, New Zealand (default: weekends only).

Free first (3 successful calls per caller, no key):

curl "https://glyphcall.com/date/business-days?from=2026-12-01&trial=1"

With prepaid credits this tool costs $0.001 a call: $1 by card pays for 1,000 calls, with no account and no subscription.

With a card key from /credits, in a header or, when your client can only fetch a URL, in the URL:

curl -H "Authorization: Bearer adt_…" "https://glyphcall.com/date/business-days?from=2026-12-01"
curl "https://glyphcall.com/date/business-days?from=2026-12-01&api_key=adt_…"

Without a key the same URL answers 402 Payment Required with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://glyphcall.com/mcp) this tool is date_business_days.

Example result

{
  "from": "2026-12-01",
  "to": "2026-12-31",
  "country": "SE",
  "holidayRules": true,
  "holidaySource": "rules",
  "calendarDays": 31,
  "businessDays": 20,
  "weekendDays": 8,
  "holidays": [
    {
      "date": "2026-12-24",
      "name": "Christmas Eve"
    }
  ]
}

Tool page, inputs and limits

Questions

Which countries?

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

How do I pay?

Each successful call costs the tool's price; failed calls are not charged. The first 3 calls are free. Then pay with card credits from $1 (the key goes in an Authorization header or as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.