Skip to main content

List Record Sets

List record sets across the value plane with cursor-based pagination. Filter by layer (capture, structured, resolved, product) to find sets at specific pipeline stages.

Record sets are the core storage abstraction in the Talonic value plane. Each record set is a table-like collection of records at a specific layer of the pipeline. The value plane organizes data into four layers: capture (raw OCR output), structured (extracted field values), resolved (normalized canonical values), and product (final assembled output). Record sets at each layer share the same underlying cell storage model but represent progressively refined data.

Use this endpoint to list all record sets in your workspace. Filter by layer to find sets at a specific pipeline stage, or by source_type to locate sets from a particular origin. Results support cursor-based pagination and can be sorted by creation date. Each record set contains typed cells with confidence scores and provenance metadata.

GET/v1/record-sets

Response

Response fields

dataarrayArray of record set objects.
data[].idstringRecord set UUID.
data[].namestringHuman-readable record set name.
data[].layerstringValue plane layer: capture, structured, resolved, or product.
data[].source_typestringOrigin type that created this record set.
data[].source_idstringUUID of the source entity (e.g. extraction run, job run).
data[].record_countintegerTotal number of records in this set.
data[].field_countintegerNumber of fields defined on this set.
data[].created_atstringISO 8601 creation timestamp.
data[].updated_atstringISO 8601 last update timestamp.

curl

Response

{
  "data": [
    {
      "id": "rs-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Resolution Run 2024-10-15",
      "layer": "resolved",
      "source_type": "resolution",
      "source_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "record_count": 142,
      "field_count": 12,
      "created_at": "2024-10-15T11:30:00.000Z",
      "updated_at": "2024-10-15T11:35:42.000Z"
    }
  ],
  "cursor": "eyJpZCI6InJzLWExYjJjM2Q0In0="
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.