Checkiday - National Holiday and Event API

Industry-leading Holiday and Event API by Checkiday, providing data on more than 5,000 national, international, and bizarre holidays and observances with thousands of descriptions, hashtags, images, founders, alternate names, and multi-year occurrence patterns. Routed through the apilayer marketplace with X-API-Key (apikey) header authentication and official client libraries for JavaScript, TypeScript, Python, C#, PHP, Go, Dart, Rust, and Java/Kotlin. Trusted since 2011 by media organizations including CNN, The New York Times, and USA Today.

1 APIs 0 Features

CalendarHolidaysEventsObservancesDatesTimePublic APIs

APIs

Checkiday Holiday and Event API

REST API delivering daily holiday and observance data. Provides three operations — list events for a date (`/events`), look up event details by id (`/event`), and full-text sear...

Collections

Checkiday - National Holiday and Event API

OPEN

Pricing Plans

Checkiday Plans Pricing

5 plans

PLANS

Rate Limits

Checkiday Rate Limits

5 limits

RATE LIMITS

FinOps

Checkiday Finops

FINOPS

Semantic Vocabularies

Checkiday National Holiday Api Context

40 classes · 6 properties

JSON-LD

API Governance Rules

Checkiday - National Holiday and Event API API Rules

10 rules · 6 errors 2 warnings 2 info

SPECTRAL

JSON Structure

Checkiday Event Detail Structure

14 properties

JSON STRUCTURE

Checkiday Event Summary Structure

3 properties

JSON STRUCTURE

Example Payloads

Checkiday Get Event Info Example

5 fields

EXAMPLE

Checkiday Get Events Example

5 fields

EXAMPLE

Checkiday Search Example

5 fields

EXAMPLE

Resources

Marketplace

TermsOfService

PrivacyPolicy

GitHubOrganization

GitHubOrganization

GitHubRepository

GitHubRepository

PublicAPIsListing

PublicAPIsListing

Sources

opencollection: 1.0.0
info:
  name: Checkiday - National Holiday and Event API
  version: 1.1.0
request:
  auth:
    type: apikey
    key: apikey
    value: '{{apikey}}'
    placement: header
items:
- info:
    name: Events
    type: folder
  items:
  - info:
      name: Get Events For Date
      type: http
    http:
      method: GET
      url: https://api.apilayer.com/checkiday/events
      params:
      - name: date
        value: ''
        type: query
        description: Date to get the events for. Defaults to today. Accepts dates such as `5/5/2025` or ISO `YYYY-MM-DD`.
      - name: adult
        value: ''
        type: query
        description: Include events that may be unsafe for viewing at work or by children. Defaults to false.
      - name: timezone
        value: ''
        type: query
        description: IANA Time Zone for calculating dates and times. Defaults to `America/Chicago`.
    docs: 'Get all events for a specified date. Returns the date''s events, any

      multi-day events that start on that date, and any multi-day events

      that are continuing their observance on that date.

      '
  - info:
      name: Get Event By Id
      type: http
    http:
      method: GET
      url: https://api.apilayer.com/checkiday/event
      params:
      - name: id
        value: ''
        type: query
        description: The ID of the requested Event.
      - name: start
        value: ''
        type: query
        description: The starting range of returned occurrences. Defaults to 2 years prior.
      - name: end
        value: ''
        type: query
        description: The ending range of returned occurrences. Defaults to 3 years in the future.
    docs: 'Get additional information for a specific Event, including alternate

      names, hashtags, images, sources, founders, description, how to

      observe, observance patterns, and historical and future occurrences.

      '
  - info:
      name: Search Events
      type: http
    http:
      method: GET
      url: https://api.apilayer.com/checkiday/search
      params:
      - name: query
        value: ''
        type: query
        description: The search query. Must be at least 3 characters long.
      - name: adult
        value: ''
        type: query
        description: Include events that may be unsafe for viewing at work or by children. Defaults to false.
    docs: 'Search for events matching a query string. Query must be at least 3

      characters long. Returns a list of matching Event summaries.

      '
bundled: true