---
title: "Retrieve a list of schedules."
method: GET
path: "/api/v1/schedules"
tags: ["Schedules"]
---

# Retrieve a list of schedules.

`GET /api/v1/schedules`

Required scope: `schedules:read` </br>Organization authorization: `supported`

## Query parameters

- `teamId` integer
- `search` string
- `page` integer
- `perPage` integer

## Response `200`

List of schedules that match the criteria

- OffsetBasedResponse39
  - `data` Schedule[], required
    - `id` integer, required — Id of the schedule
    - `teamId` integer, required — Id of the team that owns this schedule
    - `name` string, required — Name of the schedule
    - `visibility` 'private' | 'public', required — definitions: * `private` - Indicates the charge point access is private, only available to users from operator umbrella. * `public` - Indicates the charge point access is public.
    - `timezone` string, required — Timezone for interpreting the schedule entry times
    - `priceGroupId` integer, nullable — Id of the default price group applied during scheduled windows
    - `entryCount` integer, required — Number of entries in this schedule
    - `entries` ScheduleEntry[], nullable — List of schedule entries defining time windows and their overrides
      - `id` integer, required — Id of the schedule entry
      - `dayOfWeek` 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun', required
      - `from` string, required — Start time of this entry (HH:mm:ss)
      - `to` string, required — End time of this entry (HH:mm:ss)
      - `visibility` 'private' | 'public' — definitions: * `private` - Indicates the charge point access is private, only available to users from operator umbrella. * `public` - Indicates the charge point access is public.
      - `priceGroupId` integer, nullable — Price group override for this time window. Null means the schedule's default price group is used.
    - `selectedChargePointIds` integer[], nullable — Ids of charge points directly assigned to this schedule
    - `selectedSiteIds` integer[], nullable — Ids of sites assigned to this schedule
    - `createdAt` string, date-time, required — When the schedule was created
    - `updatedAt` string, date-time, nullable — When the schedule was last updated
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

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