# Holiday API

**Canonical:** https://apis.io/providers/holidays/  
**Website:** https://holidayapi.com/  
**APIs profiled:** 4

Holiday API is a commercial reference-data service that delivers verified public holidays, observances, country and language metadata, and workday calculations for 250 countries and 3,680+ state/province subdivisions in 100+ languages. Operated by Gravity Boulevard, LLC, it exposes five JSON endpoints under https://holidayapi.com/v1/ with official client libraries for Go, Node.js, PHP, Python, Ruby, and Raku.

## Kin Score — 51.1 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 51.1).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 64.3 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 23.7 |
| Developer Ergonomics | 40.5 |
| Commercial Clarity | 67.1 |
| Access Clarity | 67.1 |

## Agent readiness — 31.6 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | na |
| MCP Server | no |
| Auth Clarity | no |
| Idempotency | na |
| Error Semantics | no |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | na |

## Access

Freemium — onboarding: unknown, pricing: freemium, trial: no (confidence: medium).

## APIs (4)

- **Holiday API Countries API** — Country metadata, codes, languages, currencies, and subdivisions.
- **Holiday API Holidays API** — Public holidays and observances for countries, states, and provinces.
- **Holiday API Languages API** — Supported languages for retrieving localized holiday names.
- **Holiday API Workdays API** — Working / business day calculations honoring country workweeks and holidays.

## Agentic access (1)

- **Holidays Agentic Access** — 5 operations

## Security (1)

- **Holidays Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Holidays Plans Pricing**

## Use cases (7)

- **Calendar and Scheduling Apps** — Mark public holidays on calendar UIs and prevent scheduling on non-business days.
- **Business Day SLA Calculation** — Compute promised-by dates that honor weekends and country-specific holidays.
- **HR and Payroll Systems** — Determine paid time off, observed holidays, and country-specific leave eligibility.
- **Localized Marketing Campaigns** — Time outreach to align with public holidays in target countries and languages.
- **E-commerce Fulfillment** — Forecast shipping ETAs that respect carrier and destination-country holidays.
- **Financial Settlement** — Adjust transaction value dates and settlement windows around bank holidays.
- **Global Workforce Management** — Coordinate distributed teams across regions with accurate observed-holiday data.

## Tags

Calendar, Holidays, Public Holidays, Observances, Reference Data, Countries, Language, Workdays, Business Days, Localization

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/holidays/). Scores are computed from the provider's own public artifacts under a published rubric.