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.
Checkiday - National Holiday and Event API publishes 1 API contract indexed on the APIs.io network: Events API. Tagged areas include Calendar, Holidays, Event, Observances, and Dates.
The Checkiday - National Holiday and Event API catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Checkiday - National Holiday and Event API’s developer surface includes authentication, developer portal, signup flow, pricing, support, engineering blog, and 23 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Open Source Surface applies to this provider. This product is open source and we
read its repository directly, so Open Source Surface carries
10 points of the composite. It is scored from what the repository actually
publishes — a security policy, a contribution guide, a release history, a code of conduct — read live from the
provider rather than inferred from our own catalog pointers.
This facet adds; nothing was taken away to make room for it. An open-source project is not excused from
the commercial facets, because exemption would strip it of the points it does earn.
If we have the wrong repository, or this product is not open source, say so on your
provider repo and we
will drop the facet rather than have you publish against it.
Create-or-Update Ergonomics does not apply to this provider. The published contracts declare
no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's
denominator entirely — not scored zero. A reference or data API is not deficient for being unable to
upsert.
The six quality facets above are damped to 75 points between them,
because both conditional facets apply and carry
25 points together. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/checkiday-national-holiday-api/"><img src="https://apis.io/badge/checkiday-national-holiday-api/card.svg" alt="Checkiday - National Holiday and Event API on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Typed Event Surface+6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks
5 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
Access Clarityscores 25.0 — up to +15.0 composite points
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
aid: checkiday-national-holiday-api
deliveryModel:
model: open-core
license: MIT
open_source: true
commercial: true
callable_host: true
label: Open core · an OSS project plus a commercial hosted product
confidence: high
source:
- license
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/checkiday-national-holiday-api.png
name: Checkiday - National Holiday and Event API
description: '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.
'
url: https://apilayer.com/marketplace/checkiday-api
specificationVersion: '0.23'
created: '2026-05-28'
modified: '2026-05-30'
x-source: public-apis/public-apis
x-category: Calendar
x-type: company
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Calendar
- Holidays
- Event
- Observances
- Dates
- Time
- Public APIs
tags_raw:
- Calendar
- Holidays
- Events
- Observances
- Dates
- Time
- Public APIs
apis:
- aid: checkiday-national-holiday-api:checkiday-national-holiday-api-events-api
name: Checkiday - National Holiday and Event API Events API
description: List, search, and retrieve holidays, observances, and events.
humanURL: https://apilayer.com/marketplace/checkiday-api
baseURL: https://api.apilayer.com/checkiday
tags:
- Event
tags_raw:
- Events
properties:
- type: OpenAPI
url: openapi/checkiday-national-holiday-api-events-api-openapi.yml
- type: Documentation
url: https://apilayer.com/marketplace/checkiday-api
- type: APIReference
url: https://apilayer.com/marketplace/checkiday-api
- type: Authentication
url: https://apilayer.com/marketplace/checkiday-api
- type: Signup
url: https://apilayer.com/marketplace/checkiday-api#pricing
- type: Pricing
url: https://apilayer.com/marketplace/checkiday-api#pricing
- type: RateLimits
url: rate-limits/checkiday-rate-limits.yml
- type: Plans
url: plans/checkiday-plans-pricing.yml
- type: SDKs
url: https://github.com/westy92/holiday-event-api-js
- type: SDKs
url: https://github.com/westy92/holiday-event-api-python
- type: SDKs
url: https://github.com/westy92/holiday-event-api-csharp
- type: SDKs
url: https://github.com/westy92/holiday-event-api-php
- type: SDKs
url: https://github.com/westy92/holiday-event-api-go
- type: SDKs
url: https://github.com/westy92/holiday-event-api-dart
- type: SDKs
url: https://github.com/westy92/holiday-event-api-rust
- type: SDKs
url: https://github.com/westy92/holiday-event-api-java
- type: JSONSchema
url: json-schema/checkiday-event-summary-schema.json
- type: JSONSchema
url: json-schema/checkiday-event-detail-schema.json
- type: JSONSchema
url: json-schema/checkiday-get-events-response-schema.json
- type: JSONSchema
url: json-schema/checkiday-get-event-info-response-schema.json
- type: JSONSchema
url: json-schema/checkiday-search-response-schema.json
- type: JSONStructure
url: json-structure/checkiday-event-summary-structure.json
- type: JSONStructure
url: json-structure/checkiday-event-detail-structure.json
- type: CodeExamples
url: examples/checkiday-get-events-example.json
- type: CodeExamples
url: examples/checkiday-get-event-info-example.json
- type: CodeExamples
url: examples/checkiday-search-example.json
common:
- type: Plans
url: plans/checkiday-plans-pricing.yml
- type: RateLimits
url: rate-limits/checkiday-rate-limits.yml
- type: FinOps
url: finops/checkiday-finops.yml
- type: IssueTracker
url: https://github.com/westy92/holiday-event-api-js/issues
- type: Releases
url: https://github.com/westy92/holiday-event-api-js/releases
- type: License
name: MIT
url: https://github.com/westy92/holiday-event-api-js/blob/main/LICENSE
- type: PostmanWorkspace
url: https://www.postman.com/kinlaneapi/checkiday---national-holiday-and-event-api/overview
- type: AgenticAccess
url: agentic-access/checkiday-national-holiday-api-agentic-access.yml
- type: DomainSecurity
url: security/checkiday-national-holiday-api-domain-security.yml
- type: Authentication
url: authentication/checkiday-national-holiday-api-authentication.yml
- type: Website
url: https://apilayer.com/marketplace/checkiday-api
- type: Portal
url: https://apilayer.com/
- type: Marketplace
url: https://apilayer.com/marketplace
- type: Signup
url: https://apilayer.com/marketplace/checkiday-api#pricing
- type: Login
url: https://apilayer.com/auth/login
- type: Pricing
url: https://apilayer.com/marketplace/checkiday-api#pricing
- type: TermsOfService
url: https://apilayer.com/terms
- type: PrivacyPolicy
url: https://apilayer.com/privacy-policy
- type: Support
url: https://apilayer.com/contact
- type: Contact
url: https://apilayer.com/contact
- type: StatusPage
url: https://status.apilayer.com/
- type: Blog
url: https://blog.apilayer.com/
- type: GitHubOrganization
url: https://github.com/westy92
- type: GitHubRepository
url: https://github.com/westy92/holiday-event-api-js
- type: PublicAPIsListing
url: https://github.com/public-apis/public-apis
- type: JSONLD
url: json-ld/checkiday-national-holiday-api-context.jsonld
- type: Resources
name: Checkiday Vocabulary
url: vocabulary/checkiday-national-holiday-api-vocabulary.yml
- type: Resources
name: Checkiday Spectral Rules
url: rules/checkiday-rules.yml
- type: Resources
name: Checkiday FinOps
url: finops/checkiday-finops.yml
features:
- name: 5,000+ Holidays
description: Coverage of more than 5,000 national, international, and bizarre holidays and observances across the calendar
year.
- name: Multi-day Event Awareness
description: Distinguishes single-day events, multi-day events that start on a date, and multi-day events still ongoing
on a date.
- name: Rich Event Detail
description: Each event exposes descriptions in plain text, HTML, and Markdown, plus alternate names, founders, hashtags,
sources, and how-to-observe text.
- name: Image Assets
description: Small, medium, and large image variants for each event suitable for editorial and social-media use.
- name: Occurrence Patterns
description: Historical and forward-looking occurrence dates with configurable start and end year ranges, plus per-pattern
length and observance rules.
- name: Full-text Event Search
description: Search across all events by name or description with adult-content filtering.
- name: Timezone-aware Date Lookups
description: IANA timezone parameter ensures the "today" date is calculated correctly across regions and DST boundaries.
- name: Adult Content Filtering
description: Optional `adult` flag toggles inclusion of events that may be unsafe for viewing at work or by children.
- name: Per-response Rate-limit Visibility
description: Every response echoes the monthly quota and remaining requests as JSON fields and HTTP headers.
- name: Eight Official Client SDKs
description: First-party libraries for JavaScript, TypeScript, Python, C#, PHP, Go, Dart, Rust, and Java/Kotlin published
to their canonical package registries.
useCases:
- name: Editorial Calendar Planning
description: Newsrooms and content teams plan daily articles, social posts, and segments around recognized holidays and
observances.
- name: Social Media Automation
description: Schedulers and bots auto-generate hashtag-aware posts celebrating each day's holidays across multiple channels.
- name: Marketing Campaign Triggers
description: E-commerce and retail platforms launch themed promotions tied to seasonal and bizarre holidays.
- name: Chatbot and Assistant Enrichment
description: Conversational AI surfaces today's events when greeting users or building daily briefings.
- name: Email and Push Notifications
description: Newsletter platforms include "today is..." segments using the events feed.
- name: Restaurant and Hospitality Specials
description: Food-themed holidays drive daily menus, specials, and POS promotions.
- name: Education and Classroom Activities
description: Teachers use holiday data to anchor lessons, vocabulary, and discussion topics.
integrations:
- name: Slack
description: Post the day's events into team channels via webhook automations.
- name: Discord
description: Community bots (e.g. `1upbyte/Checkiday-Discord`) report the day's holidays in servers.
- name: Zapier
description: Trigger workflows when specific holidays occur or are upcoming.
- name: Make (Integromat)
description: Compose multi-step automations that consume the events feed.
- name: HubSpot
description: Drive marketing-automation workflows from upcoming-holiday triggers.
- name: Mailchimp
description: Inject today's holidays into transactional and broadcast emails.
- name: Buffer
description: Schedule holiday-themed social posts in advance.
- name: WordPress
description: Plugins embed today's holidays in publisher sidebars and blog posts.
- name: Shopify
description: Holiday-aware merchandising and email triggers for storefronts.
- name: Sopel IRC
description: '`sopel-checkiday` community plugin surfaces holidays in IRC channels.'
solutions:
- name: Free Tier
description: 100 monthly requests with no credit card for evaluation and hobby projects.
- name: Basic Tier
description: 5,000 monthly requests at $9.99/month for small applications and indie publishers.
- name: Pro Tier
description: 50,000 monthly requests at $49.99/month for production media and marketing workloads.
- name: Enterprise Tier
description: 250,000 monthly requests at $99.99/month for high-volume publishers and platforms.
- name: Custom Volume
description: Negotiated pricing above 250k requests for enterprises and aggregators.
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
Checkiday - National Holiday and Event API — frequently asked questions
Does Checkiday - National Holiday and Event API have an API?
Yes. APIs.io lists 1 API from Checkiday - National Holiday and Event API, including Checkiday - National Holiday and Event API Events API.
Is there an OpenAPI specification for the Checkiday - National Holiday and Event API?
Yes. APIs.io indexes 1 OpenAPI specification for Checkiday - National Holiday and Event API, each linked for download from this page.
How do I authenticate with the Checkiday - National Holiday and Event API?
Checkiday - National Holiday and Event API uses bearer-token authentication (apiKey · 1 scheme). The details are profiled on APIs.io as Checkiday National Holiday Api Authentication.
How much does the Checkiday - National Holiday and Event API cost?
Checkiday - National Holiday and Event API publishes its prices; its Free Plan plan is $0.00 as of 2026-10-28. APIs.io lists 5 pricing plans for Checkiday - National Holiday and Event API, with each plan's price, limits and inclusions under Pricing on this page.
Is the Checkiday - National Holiday and Event API ready for AI agents?
Checkiday - National Holiday and Event API has a Kin Score of 44.6 out of 100 (developing) and an Agent Readiness score of 29.1 (agent-ready), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: