---
title: "Get market calendar by ID"
method: GET
path: "/v1/market-calendar/{market_calendar_id}"
tags: ["Exchange"]
---

# Get market calendar by ID

`GET /v1/market-calendar/{market_calendar_id}`

## Request

- Base URL: `https://perp-api.phoenix.trade`
- URL: `https://perp-api.phoenix.trade/v1/market-calendar/{market_calendar_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/phoenix/apis/phoenix-eternal-api/docs/v1/market-calendar/:market_calendar_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Handles `GET /v1/market-calendar/{market_calendar_id}` via `get.v1.market_calendar.by_market_calendar_id`.

## Path parameters

- `market_calendar_id` string, required

## Response `200`

Market calendar

- MarketCalendarRecord
  - `calendar` CommodityMarketCalendarView
    - `dateOverrides` object, required
    - `weeklySchedule` object, required
  - `calendarUri` string, required
  - `contentSha256` string, required
  - `description` string, required
  - `kind` string, required
  - `loadedAt` string, date-time, required
  - `marketCalendarId` string, required
  - `rawJson` string, required
  - `s3Path` string, required
  - `updatedAt` string, date-time, required

## Other responses

- `404`: Standard JSON error payload.

---

[API](https://skmtc.dev/phoenix/apis/phoenix-eternal-api.md) - [All operations](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/revisions/542796fe0648?raw)