---
title: "Get liturgical calendar for a specific year"
method: GET
path: "/api/v1/calendar/{year}"
tags: ["Calendar"]
---

# Get liturgical calendar for a specific year

`GET /api/v1/calendar/{year}`

Retrieves complete liturgical calendar information including all seasons and special days for the specified year

## Path parameters

- `year` integer, required

## Query parameters

- `tradition` string

## Response `200`

Liturgical calendar for the specified year

- object
  - `data` object
    - `year` integer
    - `tradition` string
    - `seasons` LiturgicalSeason[]
      - `id` string — Unique identifier for the season
      - `name` string — Name of the liturgical season
      - `color` string — Liturgical color for the season
      - `startDate` string, date — Start date of the season
      - `endDate` string, date — End date of the season
      - `traditionId` string — ID of the associated tradition
    - `specialDays` object[]
      - `name` string
      - `date` string, date
      - `type` string

## Other responses

- `400` — Invalid year
- `404` — Calendar not found for the specified year
- `500` — Internal server error

---

[API](https://skmtc.net/asachs01/apis/lectionary-api.md) · [All operations](https://skmtc.net/asachs01/apis/lectionary-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asachs01/lectionary-api/versions/fd90664c991c/schema)