---
title: "List calendars"
method: GET
path: "/v1/programs/{programId}/calendars"
tags: ["List calendars"]
---

# List calendars

`GET /v1/programs/{programId}/calendars`

List calendars for a program.

You can use the following fields to filter the results. At most one of these fields should be filled.
- `dueDay`
- `programCalendarStrategyId`
- `divisionId`

## Path parameters

- `programId` integer, required

## Query parameters

- `dueDay` integer
- `programDueDateId` integer
- `programCalendarStrategyId` integer
- `includeDivisionCalendars` boolean
- `divisionId` integer
- `perPage` integer
- `nextCursor` integer

## Headers

- `x-cid` string

## Response `200`

OK

- GetCalendarsResponseDto — Response returned by calendar list
  - `has_next` boolean — Is there is a next page?
  - `next_cursor` integer — Cursor for the next page
  - `calendars` CalendarDto[] — List of calendars
    - `calendar_id` integer — Calendar ID
    - `cycle_closing_date` string, date — Cycle closing date. Format = yyyy-mm-dd.
    - `due_date` string, date — Due date. Format = yyyy-mm-dd.
    - `real_due_date` string, date — Real due date
    - `program_due_date_id` integer — Program due date ID
    - `program_calendar_strategy_id` integer — Program calendar strategy ID
    - `division_id` integer — Division ID

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)