v3

latestOpenAPI 3.1.02026-07-31134764.4 KB
tables

Run a structured query across one or more tables

Runs a structured query against Clay table data and returns records with field metadata. Results are paginated: pass the returned cursor back to fetch the next page. Scans return rows in least-recently-updated-first order and reflect writes that land while you paginate — a scan returns every record visible when it started and picks up records written while it runs, and a record updated mid-scan can be returned again with fresher data, so deduplicate by id if you need each record once.

post/tables/query

Request body

cursorstring

Opaque cursor from the previous response. Scans page in least-recently-updated-first order and reflect concurrent writes: a record updated mid-scan can be returned again, so deduplicate by id.

limitinteger

Response

200

cursorstring
dataobject[] required
fieldsobject