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

# Get calendar by code

`GET /api-regulated/v1/calendars/{calendarCode}`

## Request

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

Returns details for a specific financial center calendar including weekend rules and metadata

## Path parameters

- `calendarCode` string, required

## Response `200`

Calendar found

- CalendarDTO: Schema for representing a Calendar
  - `calendarCode` string: Industry standard calendar codes
  - `description` string: Calendar description
  - `isoCountryCode` string: ISO 3166-1 alpha-2 country code
  - `isSundayWeekend` boolean: Indicates if Sunday is a weekend for this calendar
  - `isMondayWeekend` boolean: Indicates if Monday is a weekend for this calendar
  - `isTuesdayWeekend` boolean: Indicates if Tuesday is a weekend for this calendar
  - `isWednesdayWeekend` boolean: Indicates if Wednesday is a weekend for this calendar
  - `isThursdayWeekend` boolean: Indicates if Thursday is a weekend for this calendar
  - `isFridayWeekend` boolean: Indicates if Friday is a weekend for this calendar
  - `isSaturdayWeekend` boolean: Indicates if Saturday is a weekend for this calendar
  - `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

- `403`: Access denied — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `404`: Calendar not found — [`http/resource-not-found`](/problems/http/resource-not-found/)

---

[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)