---
title: "List schedules"
method: GET
path: "/v1/schedules"
tags: ["Schedule"]
---

# List schedules

`GET /v1/schedules`

Returns paginated schedule groups, each with its nested interview events. Record timestamp filters narrow the schedule records and are combined with IDs when supplied. Use the cursor to continue the same filtered result set.

## Query parameters

- `cursor` string — Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters.
- `limit` integer — Page size. Must be between 1 and 100; defaults to 25.
- `ids` string[], nullable — Comma-separated list of IDs; maximum 100 values.
- `created_at_gte` string, date-time — Filters records created at or after this timestamp.
- `created_at_lte` string, date-time — Filters records created at or before this timestamp.
- `updated_at_gte` string, date-time — Filters records updated at or after this timestamp.
- `updated_at_lte` string, date-time — Filters records updated at or before this timestamp.

## Response `200`

Success

- object
  - `data` Schedule[], required
    - `id` string, required — Canonical schedule ID (sch_ followed by 32 lowercase hexadecimal UUID characters).
    - `application` object, required
      - `id` string, required — Canonical application ID (app_ followed by 32 lowercase hexadecimal UUID characters).
      - `candidate` object, required
        - `id` string, required — Canonical candidate ID (can_ followed by 32 lowercase hexadecimal UUID characters).
        - `name` string, required
      - `job` object, required
        - `id` string, required — Canonical job ID (job_ followed by 32 lowercase hexadecimal UUID characters).
        - `name` string, required
      - `stage` object, required
        - `id` string, required — Canonical job stage ID (stg_ followed by 32 lowercase hexadecimal UUID characters).
        - `name` string, required
    - `status` 'SCHEDULED' | 'PARTIALLY_DECLINED' | 'CANCELED', required
    - `start_at` string, date-time, required — ISO 8601 timestamp.
    - `end_at` string, date-time, required — ISO 8601 timestamp.
    - `timezone` string, required
    - `interviews` InterviewEvent[], required
      - `id` string, required — Canonical interview event ID (int_ followed by 32 lowercase hexadecimal UUID characters).
      - `schedule_id` string, required — Canonical schedule ID (sch_ followed by 32 lowercase hexadecimal UUID characters).
      - `name` string, required
      - `start_at` string, date-time, required — ISO 8601 timestamp.
      - `end_at` string, date-time, required — ISO 8601 timestamp.
      - `timezone` string, required
      - `status` 'SCHEDULED' | 'COMPLETED' | 'CANCELED', required
      - `application` object, required
        - `id` string, required — Canonical application ID (app_ followed by 32 lowercase hexadecimal UUID characters).
        - `candidate` object, required
          - `id` string, required — Canonical candidate ID (can_ followed by 32 lowercase hexadecimal UUID characters).
          - `name` string, required
        - `job` object, required
          - `id` string, required — Canonical job ID (job_ followed by 32 lowercase hexadecimal UUID characters).
          - `name` string, required
        - `stage` object, required
          - `id` string, required — Canonical job stage ID (stg_ followed by 32 lowercase hexadecimal UUID characters).
          - `name` string, required
      - `interviewers` object[], required
        - `id` string, required — Canonical employee ID (emp_ followed by 32 lowercase hexadecimal UUID characters).
        - `name` string, required
        - `role` 'INTERVIEWER' | 'SHADOW' | 'REVERSE_SHADOW', required
        - `rsvp` 'ACCEPTED' | 'DECLINED' | 'TENTATIVE' | 'NEEDS_ACTION' | 'MISSED', required
      - `video_meeting_url` string, uri, nullable, required
      - `is_debrief` boolean, required
      - `created_at` string, date-time, required — ISO 8601 timestamp.
      - `updated_at` string, date-time, required — ISO 8601 timestamp.
    - `task` object, nullable, required
      - `id` string, required — Canonical task ID (tsk_ followed by 32 lowercase hexadecimal UUID characters).
    - `created_at` string, date-time, required — ISO 8601 timestamp.
    - `updated_at` string, date-time, required — ISO 8601 timestamp.
    - `app_url` string, uri, required
  - `pagination` Pagination, required
    - `next_cursor` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `410` — Gone
- `500` — Internal error

---

[API](https://skmtc.dev/modernloop/apis/modernloop-platform-api.md) · [All operations](https://skmtc.dev/modernloop/apis/modernloop-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modernloop/modernloop-platform-api/revisions/33a0f9f44e4c/schema)