---
title: "Get a schedule"
method: GET
path: "/v1/schedules/{scheduleId}"
tags: ["schedules"]
---

# Get a schedule

`GET /v1/schedules/{scheduleId}`

## Request

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

Retrieve a previously created schedule by id.

## Path parameters

- `scheduleId` string, required

## Response `200`

Default Response

- object
  - `schedule` object, required: A schedule, including additional historical attributes. Timestamps are epoch seconds.
    - `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.

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: 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)