---
title: "Shared working days between countries, or a public-holiday ranking"
method: GET
path: "/api/holidays.json"
---

# Shared working days between countries, or a public-holiday ranking

`GET /api/holidays.json`

## Request

- Base URL: `https://geo-parity.com`
- URL: `https://geo-parity.com/api/holidays.json`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in query parameter `key`

With `countries` (two or more, comma-separated): weekdays on which nobody is on a public holiday — the working days a distributed team genuinely shares. Without: countries ranked by nationwide public holidays. Weekend holidays are excluded; regional holidays are counted separately. 204 countries, excluding India, Thailand, Malaysia, the UAE and Saudi Arabia, which return 422 NO_DATA.

## Query parameters

- `countries` string
- `year` number
- `sort` 'most' | 'fewest'
- `limit` number

## Response `200`

Overlap or ranking, with an attribution block

## Other responses

- `400`: Fewer than two countries given (code TOO_FEW)
- `422`: No calendar for one of the countries (code NO_DATA)

---

[API](https://skmtc.dev/geo-parity/apis/geo-parity-api.md) · [All operations](https://skmtc.dev/geo-parity/apis/geo-parity-api/llms.txt) · [OpenAPI document](https://skmtc.dev/geo-parity/apis/geo-parity-api/revisions/8ddff47a0806?raw)