---
title: "Get table"
method: GET
path: "/reference-data/v1/tables/{tableUrn}"
tags: ["Reference data"]
---

# Get table

`GET /reference-data/v1/tables/{tableUrn}`

## Request

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

Retrieve a reference data table by URN.

The response contains the table name and description, its attributes, the total number of published records, and the URNs of any reviews pending for the table.

## Path parameters

- `tableUrn` 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.

## Response `200`

A table object.

- Table
  - `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)