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

# List schedules

`GET /schedules`

Returns a paginated list of schedules owned or administered by the authenticated user.

## Query parameters

- `subdomain` string
- `name` string
- `type` 'venue' | 'talent' | 'curator'
- `page` integer
- `per_page` integer

## Response `200`

List of schedules

- object
  - `data` Schedule[]
    - `id` string — Encoded schedule ID
    - `subdomain` string — Unique subdomain identifier for the schedule
    - `url` string, uri — Public URL of the schedule
    - `type` 'venue' | 'talent' | 'curator' — Type of schedule
    - `name` string — Display name of the schedule
    - `email` string, email, nullable — Contact email
    - `phone` string, nullable — Contact phone number
    - `website` string, nullable — Website URL
    - `description` string, nullable — Schedule description (may contain markdown)
    - `short_description` string, nullable — Short description of the schedule (plain text, max 200 characters)
    - `timezone` string, nullable — IANA timezone identifier
    - `language_code` string, nullable — Language code
    - `profile_image_url` string, uri, nullable — URL of the schedule's profile image
    - `address1` string, nullable — Street address
    - `city` string, nullable — City
    - `state` string, nullable — State or province
    - `postal_code` string, nullable — Postal or ZIP code
    - `country_code` string, nullable — Country code
    - `created_at` string, date-time, nullable — ISO 8601 creation timestamp
    - `updated_at` string, date-time, nullable — ISO 8601 last update timestamp
    - `groups` Group[] — Sub-schedules belonging to this schedule
      - `id` string — Encoded sub-schedule ID
      - `name` string — Sub-schedule name
      - `slug` string — URL-friendly slug
      - `color` string, nullable — Color associated with this sub-schedule
  - `meta` Pagination
    - `current_page` integer — Current page number
    - `from` integer, nullable — First item number on this page
    - `last_page` integer — Last page number
    - `per_page` integer — Items per page
    - `to` integer, nullable — Last item number on this page
    - `total` integer — Total number of items
    - `path` string, uri — Base URL for pagination

## Other responses

- `401` — Missing or invalid API key

## Changes

- **2026-02-17** `c1e54e26b0db` — 3 info
  - added the new optional `query` request parameter `subdomain`
  - added the optional property `data/items/profile_image_url` to the response with the `200` status
  - added the optional property `data/items/updated_at` to the response with the `200` status
- **2026-02-12** `2596baa89e80` — 1 breaking
  - for the `query` request parameter `per_page`, the max was decreased from `1000.00` to `500.00`
- **2026-02-12** `98078a07fd7a` — 1 info
  - added the optional property `data/items/short_description` to the response with the `200` status
- **2026-02-11** `e24c8532211b` — 1 info
  - api operation id `list_schedules` was added
- **2026-02-11** `36ccba39bc4d` — 4 warning, 2 info
  - deleted the `query` request parameter `subdomain`
  - removed the optional property `data/items/profile_image_url` from the response with the `200` status
  - removed the optional property `data/items/short_description` from the response with the `200` status
  - removed the optional property `data/items/updated_at` from the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/eventschedule/apis/event-schedule-api/changes/schedules/get.md)

---

[API](https://skmtc.dev/eventschedule/apis/event-schedule-api.md) · [All operations](https://skmtc.dev/eventschedule/apis/event-schedule-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eventschedule/event-schedule-api/revisions/fc24d7d227c4/schema)