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

# List calendars

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

## Request

- Base URL: `https://sandbox.pismolabs.io/calendar-management`
- URL: `https://sandbox.pismolabs.io/calendar-management/v1/programs/{programId}/calendars`
- Auth: HTTP bearer

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.dev/pismo/apis/revolving-credit-calendar-management.md) - [All operations](https://skmtc.dev/pismo/apis/revolving-credit-calendar-management/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/revolving-credit-calendar-management/revisions/28a722ae3976?raw)