Holiday API · Example Payload

Holidays List Holidays Example

CalendarHolidaysPublic HolidaysObservancesReference DataCountriesLanguageWorkdaysBusiness DaysLocalization

Holidays List Holidays 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

statusrequestsholidays

Example Payload

Raw ↑ 
{
  "status": 200,
  "requests": {
    "used": 949,
    "available": 51,
    "resets": "2026-06-01 00:00:00"
  },
  "holidays": [
    {
      "name": "New Year's Day",
      "date": "2025-01-01",
      "observed": "2025-01-01",
      "public": true,
      "country": "US",
      "uuid": "82f78b8a-019e-479e-a19f-99040275f9bf",
      "weekday": {
        "date": {
          "name": "Wednesday",
          "numeric": "3"
        },
        "observed": {
          "name": "Wednesday",
          "numeric": "3"
        }
      }
    },
    {
      "name": "Independence Day",
      "date": "2025-07-04",
      "observed": "2025-07-04",
      "public": true,
      "country": "US",
      "uuid": "88268759-9b90-468c-804f-b729b8418e7c",
      "weekday": {
        "date": {
          "name": "Friday",
          "numeric": "5"
        },
        "observed": {
          "name": "Friday",
          "numeric": "5"
        }
      }
    }
  ]
}

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-holidays-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.