---
title: "Get VenaTable"
method: GET
path: "/models/{modelId}/venaTables/{venaTableId}"
tags: ["Vena tables [Beta]"]
---

# Get VenaTable

`GET /models/{modelId}/venaTables/{venaTableId}`

## Request

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

Returns metadata for a single VenaTable, including a live `estimatedRowCount` computed via `COUNT(*)` against the staging database. Use this endpoint for capacity planning before initiating an export. If the count query fails or times out, `estimatedRowCount` falls back to `0` and the request still returns `200`.

## Path parameters

- `modelId` string, required
- `venaTableId` string, required

## Response `200`

Successfully retrieved the VenaTable with estimatedRowCount.

- VenaTableDetail: Metadata for a single VenaTable as returned in list responses. Does not include `estimatedRowCount` — see `VenaTableDetail` (the single-table endpoint) for that. `columnNames` is used instead of `columns` so a richer column object can be added later without a breaking rename.
  - `id` string, required: Unique identifier of the VenaTable (`Id`), serialized as a string.
  - `name` string, required: Display name of the VenaTable as configured in the Vena model.
  - `columnNames` string[], required: Ordered list of column names for this VenaTable.
  - `estimatedRowCount` integer, nullable: Approximate row count via live COUNT(*). Returns 0 when the count query fails or times out.

## Other responses

- `401`: Invalid authentication credentials
- `403`: Authenticated user does not have access to the specified model
- `404`: Not found. All cases use `error.type` `NOT_FOUND` (same standard type as hierarchy and intersections). Distinguished by `error.message`: - Model missing or other tenant — `The data model {modelId} was not found...` - VenaTable missing, belongs to a different model, or is operational (excluded from the Public Export API) — `The VenaTable {venaTableId} was not found in model {modelId}.`
- `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/models/:modelId/venaTables/:venaTableId/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)