---
title: "Calendars"
method: GET
path: "/api/calendars"
tags: ["Calendars"]
---

# Calendars

`GET /api/calendars`

Returns the daily or weekly learning schedule for a given date.

## Query parameters

- `diaspora` '0' | '1'
- `custom` 'ashkenazi' | 'sephardi' | 'edot%20hamizrach'
- `year` number
- `month` number
- `day` number
- `timezone` unknown

## Response `200`

Successful Response

- CalendarAPIResponse — A response from the Calendar API
  - `date` string, date — The datestring for the calendars shown. It should match the values submitted in `year` `month` `day` or should be the current date.
  - `timezone` string — An IANA timezone name
  - `calendar_items` object[]
    - `title` object — The learning schedule title in `he` and `en`
      - `en` string
      - `he` string
    - `displayValue` object — The name of the reading for the selected date in the learning schedule in `en` and `he`
      - `en` string
      - `he` string
    - `url` string — The url path on Sefaria where this selection can be found
    - `ref` string — A string representing a citation to a Jewish text. A valid `Ref` consists of a title string followed optionally by a section string or a segment string. A title string is any one of the known text titles or title variants in the Sefaria Database.
    - `heRef` string — The Hebrew equivalent of the `ref`
    - `order` integer — This is used internally on Sefaria to arrange the learning schedules in the manner we choose.
    - `category` string — The primary category that this `ref` belongs to
    - `extraDetails` object — Additional details about this learning schedule entry
      - `aliyot` string[] — The breakdown of aliyot for a parashah
    - `description` object — A description of this learning schedule entry if it exists in `he` and `en`
      - `en` string
      - `he` string

---

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