ATataccama
Reference data

List published table records

Retrieve records from a published reference data table.

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

get/reference-data/v1/tables/{tableUrn}/published

Request

Path parameters

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

Example:urn:ata:acme-corp:reference-data:table:123e4567-e89b-12d3-a456-426614174000

Table URN identifier.

Query parameters

afterstring

Cursor for forward pagination. Use the value from meta.next in the previous response.

beforestring

Cursor for backward pagination. Use the value from meta.prev in the previous response.

sizeinteger

Number of records to return per page.

attributeNamesstring[]

Specific attributes to include in the response.

modestring

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

Example:EFFECTIVE_ONLY

Controls which versions of records are returned for tables with effective dates enabled. EFFECTIVE_ONLY (default) returns records currently effective at effectiveAt (or now when omitted). ALL returns every record version, regardless of effectivity. Has no effect on tables without effective dates.

effectiveAtstring date-time

Point-in-time reference for EFFECTIVE_ONLY mode (RFC 3339, for example 2026-01-15T09:30:00Z). When omitted, the current server time is used. Ignored when mode=ALL or when effective dates are not enabled on the table.

Response

Paginated list of records.

Example response

{
  "data": [
    {
      "urn": "urn:ata:acme-corp:reference-data:record:523e4567-e89b-12d3-a456-426614174004",
      "values": [
        {
          "recordUrn": "urn:ata:acme-corp:reference-data:record:523e4567-e89b-12d3-a456-426614174004"
        }
      ],
      "lastChangedByUrn": "urn:ata:acme-corp:iam:user:jane.doe@acme-corp.com"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.