---
title: "List tables"
method: GET
path: "/reference-data/v1/tables"
tags: ["Reference data"]
---

# List tables

`GET /reference-data/v1/tables`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/reference-data/v1/tables`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/reference-data/v1/tables/get.ts> (a function with typed inputs; its response is checked against the schema)

List the published reference data tables.

To narrow the list down to tables whose name matches a text, use the `search` parameter.

## Query parameters

- `after` string
- `before` string
- `size` integer
- `search` string

## Response `200`

Paginated list of tables.

- TablesListResponse: Paginated response for tables list following cursor-based pagination standard.
  - `meta` CursorPaginationMetadata, required: Pagination metadata for cursor-based pagination.
    - `prev` string: Cursor for previous page. Use with 'before' query parameter. Omitted on the first page.
    - `next` string: Cursor for next page. Use with 'after' query parameter. Omitted on the last page.
    - `total` integer: Optional total count of items.
  - `data` Table[], required: Array of table objects.
    - `urn` string, uri, required: A URN identifying a table resource in the Reference Data API. Format: urn:ata:{tenant}:reference-data:table:{uuid} Example: urn:ata:acme-corp:reference-data:table:123e4567-e89b-12d3-a456-426614174000.
    - `name` string, required
    - `description` string: Description of the table (rich text).
    - `attributes` DatasetAttribute[], required
      - `urn` string, uri, required: A URN identifying an attribute of a table in the Reference Data API. The URN carries the UUID of the table and the UUID of the attribute, so it is unique on its own. It does not change when the attribute is renamed, when its data type changes, or when it is converted between a data attribute and a reference attribute, so persist this URN when your client needs to track an attribute over time. The id is the UUID of the owning table's URN and the attribute's own UUID, separated by `/`. The table UUID stays the same across publishes. Format: urn:ata:{tenant}:reference-data:table-attribute:{tableUuid}/{attributeUuid} Example: urn:ata:acme-corp:reference-data:table-attribute:123e4567-e89b-12d3-a456-426614174000/623e4567-e89b-12d3-a456-426614174005
      - `name` string, required
      - `type` string, required: Discriminator for attribute type.
    - `totalRecordsCount` integer, required
    - `reviewUrns` ReviewUrn[]: Array of review URN strings representing pending reviews for this table.
    - `createdAt` string, date-time, required
    - `lastPublishedAt` string, date-time: When the table was last published. The table is also published when it is created, when its attributes change, and when a table it references is published, so this time can move even if none of its own records changed. Absent when no publish is recorded for the table.
    - `lastPublishedByUrn` string, uri: A URN identifying a user in the IAM API. Unlike most URNs, the last segment is the user ID as IAM knows it rather than a UUID. A user ID can be any string, for example, an email address, a UUID, or `service-account-{client ID}` for an API client. Characters that a URN cannot contain, such as spaces, `%`, or `#`, are percent-encoded as UTF-8 with uppercase hex digits; all other characters are kept as they are. Users cannot be listed or retrieved through the public API. To find a user's ID, open the user in the web application (**Global settings > User management > Users**). Format: urn:ata:{tenant}:iam:user:{user ID} Example: urn:ata:acme-corp:iam:user:jane.doe@acme-corp.com.

## Other responses

- `400`: Bad request. The request parameters or body are invalid.
- `403`: Forbidden. You do not have permission to access the requested resource.
- `404`: Not found. The requested resource does not exist.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)