Checkiday - National Holiday API API

77 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

Checkiday is a holiday data API covering more than 5,000 national days and observances in the United States, including unofficial holidays like National Pizza Day. It lets you query by date to retrieve all holidays for that day, along with descriptions and links to detailed information. An API key from APILayer is required.

Beginner Tip

The free tier on APILayer provides 100 requests/month — enough for testing. Pass your key in the apikey header, not as a query parameter, which is the most common setup mistake.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

country name and code

population

capital city

region and subregion

flag image URL

event dates and names

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "name": "Japan",
  "capital": "Tokyo",
  "population": 125800000,
  "region": "Asia",
  "languages": [
    "Japanese"
  ],
  "flag": "https://flagcdn.com/jp.svg",
  "currencies": [
    {
      "code": "JPY",
      "name": "Japanese yen"
    }
  ]
}

Field Reference

holidays[].id Unique slug identifier for the holiday, e.g., "independence-day".

holidays[].name Display name of the holiday, e.g., "Independence Day".

holidays[].url URL on Checkiday.com with detailed information and history about the holiday.

date The queried date echoed back in YYYY/MM/DD format.

timezone Timezone used to determine the current date; defaults to America/Chicago.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://apilayer.com/marketplace/checkiday-api";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

401 Unauthorized API key not passed in the apikey header

✓ Add the header -H "apikey: YOUR_KEY" to your request; this API uses a header, not a query parameter.

Empty holidays array Date string formatted incorrectly

✓ Use the format YYYY/MM/DD (e.g., 2024/07/04) with forward slashes, not dashes or other separators.

429 Rate limit exceeded Exceeded the monthly quota on the free plan

✓ Cache responses for each date you query; holiday data for a given date does not change year-over-year.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →