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

# List schedules

`GET /schedules`

## Request

- Base URL: `https://saturnsql.com/api`
- URL: `https://saturnsql.com/api/schedules`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Lists scheduled exports of saved queries (to Google Sheets or Slack), company-wide. Available to API keys with the `read` scope.

## Response `200`

Schedules

- object
  - `schedules` Schedule[]
    - `id` string
    - `savedQueryId` string
    - `cronExpression` string: 5-field cron expression evaluated in `timezone`, e.g. '0 9 * * 1' for Monday 9am
    - `timezone` string: IANA timezone, e.g. America/New_York
    - `startCell` string: A1 notation anchor for the export
    - `includeHeaders` boolean
    - `enabled` boolean
    - `nextRunAt` string, date-time, nullable
    - `lastRunAt` string, date-time, nullable
    - `lastError` string, nullable
    - `destinationType` 'sheets' | 'slack', nullable
    - `spreadsheetId` string, nullable
    - `spreadsheetName` string, nullable
    - `sheetName` string, nullable
    - `slackChannelId` string, nullable
    - `slackChannelName` string, nullable

## Other responses

- `401`: Bad or missing credentials

---

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