---
title: "Get readings for a date range"
method: GET
path: "/api/v1/readings/range"
tags: ["Readings"]
---

# Get readings for a date range

`GET /api/v1/readings/range`

Retrieves all scripture readings within a specified date range with pagination support

## Query parameters

- `start` string, date, required
- `end` string, date, required
- `tradition` string
- `page` integer
- `limit` integer

## Response `200`

List of readings for the date range

- object
  - `data` DailyReading[]
    - `id` string — Unique identifier for the reading
    - `date` string, date — Date of the reading
    - `traditionId` string — ID of the associated tradition
    - `seasonId` string — ID of the associated season
    - `readings` object[]
      - `type` 'first' | 'psalm' | 'second' | 'gospel' — Type of reading
      - `citation` string — Scripture citation
      - `text` string — Full text of the reading
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `400` — Invalid date range
- `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/revisions/fd90664c991c/schema)