---
title: "Shared working days and hours for a multi-country team"
method: GET
path: "/api/team-calendar.json"
---

# Shared working days and hours for a multi-country team

`GET /api/team-calendar.json`

## Request

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

Weekdays on which nobody in the team is on a public holiday, joined to the daily working-hour overlap across the members' time zones (evaluated on 15 January and 15 July so daylight saving is visible), and multiplied into conservative shared working hours per year. Members are ISO alpha-2 codes, each optionally `CC@IANA/Zone`; countries spanning several zones are flagged multiZone. Spine countries with no holiday calendar (IN, TH, MY, AE, SA) return 422 NO_DATA.

## Query parameters

- `members` string, required
- `year` number
- `start` number
- `end` number
- `hours` string

## Response `200`

Members, days, winter/summer hours, sharedWorkingHoursPerYear, caveats and an attribution block

## Other responses

- `400`: members missing (MISSING_PARAMS), fewer than two countries (TOO_FEW), or malformed hours/date (INVALID_HOURS, INVALID_DATE)
- `422`: Unknown country or zone (UNKNOWN_COUNTRY, UNKNOWN_ZONE), or no holiday calendar for a member (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)