Get Export Status

GET/api/v1/exports/{export_id}

Fetch an export job's current status and progress. Exports run asynchronously, so poll this endpoint until the job reaches a terminal state, then download the file.

Authentication#

Requires a token with the read scope, sent as Authorization: Bearer cornect_….

Request#

Path parameters:

Name	Type	Required	Description
`export_id`	string (UUID)	Yes	The id returned by Create Export.

Response#

json

{
  "id": "9f1c…",
  "workspace_id": "5b2fa9e8-…",
  "name": "US fintech 50+",
  "export_format": "csv",
  "source_type": "search",
  "status": "completed",          // pending | processing | completed | failed
  "total_records": 180,
  "processed_records": 180,
  "file_size_bytes": 48213,
  "created_at": "2026-05-28T12:00:00Z",
  "completed_at": "2026-05-28T12:00:09Z"
}

Polling#

Poll every 2–5 seconds until status is completed (or failed). This endpoint allows 120 requests/minute, so a few-second interval is safe. Once completed, call POST /exports/{id}/download for the file.

Code samples#

curl -X GET https://api.cornect.io/api/v1/exports/9f1c0000-0000-0000-0000-000000000000 \
  -H "Authorization: Bearer cornect_your_token_here"

Errors#

See Errors for the full table. Codes you're most likely to see here:

Code	Status	When
`—`	404	No export with that id in your workspace.
—	429	Rate limit exceeded (120/min).

Interactive reference#

Loading interactive reference…