Get export status
The job’s current state, and — once it has finished and while the file still exists — a signed download URL.
download is present only when status is completed. It is generated at the moment you poll and is valid for one hour; poll again for a fresh one rather than storing it. If the artifact exists but could not be signed, download is null and download_error is set: the export is fine, retry the poll.
status is expired once expires_at has passed, seven days after the export was created. The file is gone at that point and the export must be re-run.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The job id returned by POST /exports.
Response
The job's current state.
Only completed carries a download. expired means expires_at has passed and the file has been deleted.
queued, running, completed, failed, expired events, users, attribution csv, ndjson When the file is deleted — seven days after creation. After this the export must be re-run.
The range and filters this export was created with.
Rows written. Null until the export finishes.
True when the export reached the row cap. The file is valid but does not cover the whole requested range; narrow the range or the filters.
Why it failed. Null unless status is failed.
Present only on a completed, unexpired job. Generated at poll time, never stored. null alongside download_error means the artifact exists but could not be signed — retry the poll.
Set only when download is null on a completed job.