# Public holidays API

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

Public holidays by country: list a country's public holidays for a year. $0.01 per successful call; failed calls are never charged.

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.

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 https://glyphcall.com/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 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: https://glyphcall.com/tools/holidays

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

Business days between dates, working days calculator: count working days between two dates, skipping weekends and public holidays. $0.01 per successful call; failed calls are never charged.

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 https://glyphcall.com/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 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: https://glyphcall.com/tools/date-business-days

## Questions

Docs for agents: https://glyphcall.com/llms.txt · OpenAPI: https://glyphcall.com/openapi.json · All guides: https://glyphcall.com/guides