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

# Get live status

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

## Request

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

Whether a run is in flight right now, and when the next scheduled run fires.

## Path parameters

- `id` string, required

## Response `200`

- LiveExportStatus
  - `live_export_id` string, required
  - `status` 'draft' | 'active' | 'manual_only', required
  - `running` boolean, required: Whether a run is in flight right now — independent of the schedule.
  - `current_run` RunSummary, required
    - `id` string, required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required
    - `trigger` 'manual' | 'schedule', required: Whether a person/API started it, or the cadence did.
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `summary` string, nullable, required: The one-line story: what the run is doing right now, or how it ended.
    - `warning` string, nullable, required: Set when the run completed but a step finished with a warning.
    - `error` string, nullable, required: The rolled-up error for a failed run.
    - `app_url` string, uri, required: The run in the Whalesync app, for a person who wants to watch or share it — like every app_url, nothing here needs their attention.
  - `next_run_at` string, date-time, nullable, required: When the next scheduled run fires.
  - `last_run` RunSummary, required
    - `id` string, required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required
    - `trigger` 'manual' | 'schedule', required: Whether a person/API started it, or the cadence did.
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `summary` string, nullable, required: The one-line story: what the run is doing right now, or how it ended.
    - `warning` string, nullable, required: Set when the run completed but a step finished with a warning.
    - `error` string, nullable, required: The rolled-up error for a failed run.
    - `app_url` string, uri, required: The run in the Whalesync app, for a person who wants to watch or share it — like every app_url, nothing here needs their attention.
  - `fetched_at` string, date-time, required

## 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 belongs to someone else.
- `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)