---
title: "List calendars"
method: GET
path: "/v1/calendars"
---

# List calendars

`GET /v1/calendars`

## Request

- Base URL: `https://bankday.dev`
- URL: `https://bankday.dev/v1/calendars`
- Auth: HTTP bearer

All calendars with metadata (type, weekend days, time zone, coverage years, source). Filter with type and q. GET /v1/calendars/{id} returns one calendar plus this year's holidays.

## Query parameters

- `type` string
- `q` string

## Response `200`

OK

- object

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `422`: Error
- `429`: Error

---

[API](https://skmtc.dev/bankday/apis/bankday-api.md) · [All operations](https://skmtc.dev/bankday/apis/bankday-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bankday/apis/bankday-api/revisions/64cfaa415994?raw)