List rows (typed cells; ?cells=flat / ?format=csv)
Returns Row objects ({ object: "row", id, cells }) with polymorphic
typed cells by default (scalar / value (+run) / sequence), in
the canonical list envelope plus total (the filtered row count
for the query’s scope). ?cells=flat returns the v1-style
{ slug: value } rows (deliberately unstamped); ?format=csv
streams CSV. Supports slug-keyed filters / sort JSON and cursor
pagination — this endpoint allows limit up to 200.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Opaque pagination cursor. Pass the nextCursor from the previous
page to fetch the next one; omit for the first page.
Max rows to return. Default 50; rows allow up to 200 (vs. 100 elsewhere).
1 <= x <= 200JSON array of { column, operator, value } filters. column is
an input-column slug; operators: contains, not_contains,
equals, not_equals, is_empty, is_not_empty,
greater_than, greater_than_or_equal, less_than,
less_than_or_equal. Unknown columns → UNKNOWN_COLUMN.
JSON object { column, direction: "asc"|"desc" } (slug-keyed).
Pass flat for v1-style { slug: value } rows instead of typed cells.
flat Pass csv to stream the (flat) rows as CSV.
csv Pass false to disable the table's default filters/sort.
true, false Response
A page of rows (list envelope + total).
The canonical v2 list envelope. Every list endpoint returns this
shape; per-endpoint items element types (and documented extras
like total) are declared on each operation.
"list"The page of objects. Element type is per-endpoint.
Cursor for the next page; null means this is the last page.
The path this list was fetched from (query string excluded).
Total row count for the query's scope (all pages).