Holiday API · Example Payload

Holidays List Countries Example

CalendarHolidaysPublic HolidaysObservancesReference DataCountriesLanguageWorkdaysBusiness DaysLocalization

Holidays List Countries Example is an example object payload from Holiday API, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

statusrequestscountries

Example Payload

{
  "status": 200,
  "requests": {
    "used": 950,
    "available": 50,
    "resets": "2026-06-01 00:00:00"
  },
  "countries": [
    {
      "code": "US",
      "name": "United States of America",
      "codes": {
        "alpha-2": "US",
        "alpha-3": "USA",
        "numeric": 840
      },
      "languages": ["en"],
      "currencies": [
        {"alpha": "USD"}
      ],
      "flag": "https://holidayapi.com/images/flags/64/us.png",
      "subdivisions": [
        {
          "code": "US-CA",
          "name": "California",
          "languages": ["en"]
        },
        {
          "code": "US-TX",
          "name": "Texas",
          "languages": ["en"]
        }
      ],
      "weekend": [
        {"name": "Saturday", "numeric": 6},
        {"name": "Sunday", "numeric": 7}
      ]
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/holidays-list-countries-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.