---
title: "Get calendar dates by calendar code"
method: GET
path: "/api-regulated/v1/calendar-dates/calendar/{calendarCode}"
tags: ["CalendarDate"]
---

# Get calendar dates by calendar code

`GET /api-regulated/v1/calendar-dates/calendar/{calendarCode}`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/calendar-dates/calendar/{calendarCode}`
- Auth: HTTP bearer

Returns holidays and special dates for a specific calendar, optionally filtered by date range

## Path parameters

- `calendarCode` string, required

## Query parameters

- `fromDate` string, date
- `toDate` string, date

## Response `200`

Calendar dates retrieved successfully

- CalendarDateDTO[]
  - `id` string, uuid: ID for this calendar date
  - `calendarCode` string: Industry standard calendar codes
  - `nonBusinessDate` string: Non business date for the calendar code
  - `description` string: Non business date description
  - `eventSequence` integer: Event sequence number for event sourcing - globally monotonic across all entities
  - `versionNumber` integer: Strictly monotonically increasing version number for this record
  - `updatedBy` string: Username of the person or entity that updated this record
  - `updatedAt` string: Timestamp of the last update in UTC
  - `createdAt` string: Timestamp of creation in UTC

## Other responses

- `400`: Invalid date range — [`http/malformed-request`](/problems/http/malformed-request/)
- `403`: Access denied — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)