Vena tables [Beta]
Get Vena Table Export Status
Changed onBeta. Returns the current build status of a Vena Table snapshot export as a JSON string (for example "RUNNING" or "COMPLETED").
Poll this endpoint after POST /exports until the status is COMPLETED or ERROR before fetching data. Typical polling interval: 2–5 seconds.
Internal ETL NOT_STARTED is never exposed — it is normalized to SUBMITTED.
| Status | Meaning |
|---|---|
| SUBMITTED | Job received, waiting to enter the queue |
| QUEUED | Job is in the processing queue |
| RUNNING | Snapshot is being built |
| COMPLETED | Snapshot ready — call /exports/{exportId}/data |
| ERROR | Build failed — do not fetch data; submit a new export |
| EXPIRED | Snapshot TTL elapsed (24 h) — create a new export |
get/exports/{exportId}/status
Request
- Base URLhttps://us1.vena.io/api/public/v1
- AuthHTTP basic
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
exportIdstring required
Example:123456789012345678
Export job ID returned from POST /exports
Response
Current export status as a JSON string (not an object). Never returns NOT_STARTED.
'SUBMITTED' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'ERROR' | 'EXPIRED' required
Public export status as a JSON string. NOT_STARTED is never exposed (mapped to SUBMITTED).
Example response
"COMPLETED"
Changes
- info
endpoint added
- info