---
title: "Get Vena Table Export Status"
method: GET
path: "/exports/{exportId}/status"
tags: ["Vena tables [Beta]"]
---

# Get Vena Table Export Status

`GET /exports/{exportId}/status`

## Request

- Base URL: `https://us1.vena.io/api/public/v1`
- URL: `https://us1.vena.io/api/public/v1/exports/{exportId}/status`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/venasolutions/apis/vena-api/docs/exports/:exportId/status/get.ts> (a function with typed inputs; its response is checked against the schema)

**Beta.** 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 |

## Path parameters

- `exportId` string, required

## Response `200`

Current export status as a JSON string (not an object). Never returns `NOT_STARTED`.

- 'SUBMITTED' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'ERROR' | 'EXPIRED': Public export status as a JSON string. NOT_STARTED is never exposed (mapped to SUBMITTED).

## Other responses

- `401`: Invalid authentication credentials
- `403`: Authenticated user does not have access to the export's model. Variants: forbiddenModel.
- `404`: Export not found or expired. Variants: exportNotFoundUnknown, exportIdInvalid, exportExpired. Unknown or invalid `exportId` uses `error.type` `NOT_FOUND` (same standard type as venaTables / hierarchy). Expired uses `EXPORT_EXPIRED`.
- `422`: The Public Export API feature is not enabled for this customer.
- `429`: Too many requests, please try again later

## Changes

- **2026-11-03** `587671c855dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/venasolutions/apis/vena-api/changes/exports/:exportId/status/get.md)

---

[API](https://skmtc.dev/venasolutions/apis/vena-api.md) - [All operations](https://skmtc.dev/venasolutions/apis/vena-api/llms.txt) - [OpenAPI document](https://skmtc.dev/venasolutions/apis/vena-api/revisions/587671c855dd?raw)