---
title: "List VenaTables"
method: GET
path: "/models/{modelId}/venaTables"
tags: ["Vena tables [Beta]"]
---

# List VenaTables

`GET /models/{modelId}/venaTables`

## Request

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

Returns metadata for all VenaTables associated with the specified data model, sorted alphabetically by name (case-insensitive). Operational tables are excluded. `estimatedRowCount` is omitted from every entry; use the single-table endpoint (`GET /models/{modelId}/venaTables/{venaTableId}`) when you need a live row count.

## Path parameters

- `modelId` string, required

## Response `200`

Successfully retrieved VenaTable metadata. Returns an empty `data` array when the model has no VenaTables.

- ListVenaTablesResponse: List envelope for VenaTable metadata. `estimatedRowCount` is absent from every entry — use GET /models/{modelId}/venaTables/{venaTableId} to get it for a specific table.
  - `data` VenaTableSummary[], required: All non-operational VenaTables on the model, sorted alphabetically by name (case-insensitive).
    - `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.
  - `metadata` HierarchyJsonResponseMetadata, required
    - `recordsReturned` integer, required

## Other responses

- `401`: Invalid authentication credentials
- `403`: Authenticated user does not have access to the specified model
- `404`: The model specified by `modelId` is not found in the authenticated tenant, including when the model belongs to a different tenant (tenant isolation by not-found). `error.type` is always `NOT_FOUND`.
- `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/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)