---
title: "Get data export status"
method: GET
path: "/export_status"
tags: ["Organization"]
---

# Get data export status

`GET /export_status`

This endpoint retrieves the status of a data export job and optionally downloads the export file (as CSV) if the export has completed successfully.

Use the `data_export_id` returned by the [Export data](/api-reference/organization/export-data) endpoint to check progress.

## Query parameters

- `user_id` string, required
- `data_export_id` string, required
- `download` boolean

## Response `200`

Export status retrieved successfully. If `download=true` and the export state is `COMPLETED`, the response body will be the CSV file.

- object
  - `data_export_id` string — The unique identifier of the data export job.
  - `state` 'REQUESTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' — Current state of the export job: - `REQUESTED` — The export has been created and is queued for processing. - `IN_PROGRESS` — The export is currently being processed. - `COMPLETED` — The export finished successfully and is available for download. - `FAILED` — The export encountered an error.
  - `created_ts` string, date-time — Timestamp when the export was created (ISO 8601).
  - `finished_ts` string, date-time — Timestamp when the export finished (ISO 8601). Only present when the state is `COMPLETED` or `FAILED`.

## Other responses

- `400` — Bad request — missing `data_export_id` parameter.
- `401` — Unauthorized — missing or invalid API key.
- `403` — Forbidden — insufficient permissions, the export does not belong to the requesting user, or the organization is not on the enterprise tier.
- `404` — Data export not found, or the export file is no longer available.
- `500` — Internal server error.

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)