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

# List schedules

`GET /v1/schedules`

## Request

- Base URL: `https://api.olostep.com`
- URL: `https://api.olostep.com/v1/schedules`
- Auth: HTTP bearer

Retrieve the schedules for the authenticated team.

## Query parameters

- `include_deleted` 'true' | 'false'

## Response `200`

Default Response

- object: A page of schedules.
  - `schedules` object[]
    - `team_id` string, required
    - `schedule_id` string, required
    - `type` 'recurring' | 'onetime'
    - `method` 'GET' | 'POST'
    - `endpoint` string
    - `payload` unknown
    - `cron_expression` string
    - `execute_at` unknown
    - `expression_timezone` unknown
    - `text` unknown
    - `state` string
    - `schedule_name` string
    - `schedule_group` string
    - `created` integer, nullable: Unix timestamp in seconds when the schedule was created.
    - `updated` integer, nullable: Unix timestamp in seconds when the schedule was last updated.
  - `count` number

## Other responses

- `401`: Default Response
- `502`: Default Response

---

[API](https://skmtc.dev/olostep/apis/olostep-api.md) · [All operations](https://skmtc.dev/olostep/apis/olostep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olostep/apis/olostep-api/revisions/13c766ab100c?raw)