List Record Sets

List record sets in the Talonic value plane with cursor pagination. Filter by layer (capture, structured, resolved, product) or by source kind.

A record set is a table-like collection of records at one layer of the Talonic value plane, the storage model that holds structured data produced by 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). Within a set, data follows the ladder Document → Record → Cell → Claim: each record maps to a source document, each cell holds one field value, and claims trace a value back to its evidence. This endpoint lists the record sets in your workspace with cursor-based pagination.

Filter by layer to find sets at a specific pipeline stage, or by kind to locate sets from a particular origin, such as structuring_run, resolution_run, or data_product. Each entry carries lifecycle metadata (name, layer, kind, status, record and field counts) plus links to the detail, fields, records, and export endpoints. Cell values themselves are read through the records endpoint, not this list.

GET/v1/record-sets

Query parameters

layerstringFilter by value plane layer: capture, structured, resolved, or product.

kindstringFilter by source kind (e.g. structuring_run, resolution_run, data_product).

limitintegerMaximum number of items to return (1-100). Default: 20

cursorstringOpaque pagination cursor from a previous response.

orderstringSort order by creation date (asc | desc). Default: desc

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[].kindstringSource kind that created this record set (e.g. structuring_run, resolution_run).

data[].source_idstring | nullUUID of the source entity (e.g. the structuring or resolution run).

data[].statusstringLifecycle state of the record set (active by default).

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[].linksobjectRelated resource URLs (self, fields, records, export).

pagination.totalintegerTotal number of record sets matching the query.

pagination.limitintegerMaximum results per page.

pagination.has_morebooleanWhether more results exist beyond this page.

pagination.next_cursorstring | nullCursor to fetch the next page. Null if no more results.

curl

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Resolution Run 2024-10-15",
      "layer": "resolved",
      "kind": "resolution_run",
      "source_id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "status": "active",
      "record_count": 142,
      "field_count": 12,
      "created_at": "2024-10-15T11:30:00.000Z",
      "links": {
        "self": "/v1/record-sets/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "fields": "/v1/record-sets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/fields",
        "records": "/v1/record-sets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/records",
        "export": "/v1/record-sets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/export"
      }
    }
  ],
  "pagination": {
    "total": 8,
    "limit": 10,
    "has_more": false,
    "next_cursor": null
  }
}

Combine layer and kind to pinpoint a pipeline stage: layer=structured with kind=structuring_run lists the raw extraction outputs, while layer=resolved with kind=resolution_run lists their normalized counterparts.

Errors

Error responses

401unauthorizedMissing or invalid API key.

429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Get Record Set

List Record Set Records

List Structuring Jobs

List Resolutions