API

Pull public holiday data into your product. Countries, regions, holiday calendars, and name translations — versioned JSON under /api/v1/.

Read the docs API pricing Get an API key

What it covers

Countries & languages /countries/
Regions / subdivisions /regions/
Public holidays by year /holidays/
Holiday name translations /translations/
Key health & monthly quota /me/

How it works

Create an API key in account settings (prefix cal_), pass it as Bearer or X-Api-Key, call /api/v1/*. Free tier includes a small monthly quota; paid plans scale with volume.

Base URL https://dev.calendra.work/api/v1/

Example

GET https://dev.calendra.work/api/v1/holidays/?country=DE&year=2026
Authorization: Bearer cal_••••••••