---
title: "Get the schedule"
method: GET
path: "/v1/live-export/live-exports/{id}/schedule"
tags: ["Live Exports"]
---

# Get the schedule

`GET /v1/live-export/live-exports/{id}/schedule`

## Request

- Base URL: `https://api.whalesync.com`
- URL: `https://api.whalesync.com/v1/live-export/live-exports/{id}/schedule`
- Auth: HTTP bearer

The export's cadence, daily run time and on/off switch, plus the cadences your plan can set. Before the first save this is a 409 `not_provisioned`; after saving, 404 until a PATCH creates the schedule.

## Path parameters

- `id` string, required

## Response `200`

- LiveExportScheduleDetail
  - `enabled` boolean, required: Whether the cadence is on. This is the on/off switch for the whole export.
  - `cadence` 'every_10_minutes' | 'every_30_minutes' | 'hourly' | 'daily' | 'custom', required
  - `time_of_day` string, nullable, required: When a `daily` export runs: a whole hour in 24-hour time, in `timezone` (UTC when no timezone is set). Null for the other cadences.
  - `cron` string, required: The exact schedule, as a cron expression. Read-only; set `cadence` and `time_of_day` instead.
  - `timezone` string, nullable, required
  - `next_run_at` string, date-time, nullable, required: When the next scheduled run fires.
  - `last_triggered_at` string, date-time, nullable, required
  - `allowed_cadences` string[], required: The cadences your plan can set. Pick from these to avoid a `plan_required` error.

## Other responses

- `401`: The API key is missing, invalid, or revoked (`missing_api_key`, `invalid_api_key`). Carries a `required_action` linking a person to key creation, naming the smallest scope this endpoint needs.
- `403`: The key's scope does not allow this call (`insufficient_scope` on a mutation with a `read` key).
- `404`: No live export with that id, or it has no schedule yet.
- `429`: Rate limit exceeded. Wait for `Retry-After` seconds.

---

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