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

# List published table records

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

## Request

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

Retrieve records from a published reference data table.

To return only some of the table's attributes, use the `attributeNames` parameter.

## 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.

## Query parameters

- `after` string
- `before` string
- `size` integer
- `attributeNames` string[]
- `mode` string: @ExtensibleEnum Controls which versions of records are returned when reading from a table with effective dates enabled. `EFFECTIVE_ONLY` (default) returns the record version effective at the chosen point in time. `ALL` returns every record version regardless of effectivity. Has no effect on tables without effective dates.
- `effectiveAt` string, date-time

## Response `200`

Paginated list of records.

- RecordsResponse: Paginated response for records 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` Record[], required: Array of record objects.
    - `urn` string, uri, required: A URN identifying a record resource in the Reference Data API. Format: urn:ata:{tenant}:reference-data:record:{uuid} Example: urn:ata:acme-corp:reference-data:record:523e4567-e89b-12d3-a456-426614174004.
    - `values` RecordValue[], required: Record attribute values.
      - `name` string, required
      - `value` unknown
      - `recordUrn` string, uri: A URN identifying a record resource in the Reference Data API. Format: urn:ata:{tenant}:reference-data:record:{uuid} Example: urn:ata:acme-corp:reference-data:record:523e4567-e89b-12d3-a456-426614174004.
    - `lastChangedAt` string, date-time: When the values of the record were last changed. A change keeps the time it was made as it moves from draft through review to publishing, so on a published record this is the time of the change, not of the publish. Absent when no change is recorded for the record. Changes are recorded shortly after they are saved, so for a record changed moments ago this can still show the previous change, or be absent if there was none.
    - `lastChangedByUrn` 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)