---
title: "List record sets"
method: GET
path: "/v1/record-sets"
tags: ["Record Sets"]
---

# List record sets

`GET /v1/record-sets`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/record-sets`
- Auth: HTTP bearer

Returns a paginated list of record sets (value-plane tables).

## Query parameters

- `layer` 'capture' | 'structured' | 'resolved' | 'product'
- `kind` string
- `limit` integer
- `cursor` string
- `order` 'asc' | 'desc'

## Response `200`

Paginated list of record sets

- object
  - `data` RecordSet[]
    - `id` string, uuid
    - `name` string
    - `layer` 'capture' | 'structured' | 'resolved' | 'product'
    - `kind` string: Source kind (e.g. structuring_run, resolution_run, data_product).
    - `source_id` string, uuid, nullable: Owning run/product ID where applicable.
    - `status` string: Lifecycle state (e.g. active).
    - `record_count` integer
    - `field_count` integer
    - `created_at` string, date-time
    - `links` object
      - `self` string
      - `fields` string
      - `records` string
      - `export` string
  - `pagination` Pagination
    - `next_cursor` string, nullable
    - `has_more` boolean

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)