---
title: "List rows (typed cells; ?cells=flat / ?format=csv)"
method: GET
path: "/tables/{tableId}/rows"
tags: ["Workspace"]
---

# List rows (typed cells; ?cells=flat / ?format=csv)

`GET /tables/{tableId}/rows`

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**.

## Query parameters

- `cursor` string
- `limit` integer
- `filters` string
- `sort` string
- `cells` 'flat'
- `format` 'csv'
- `defaults` 'true' | 'false'

## Response `200`

A page of rows (list envelope + `total`).

- object — 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.
  - `object` 'list', required
  - `items` Row[], required — The page of objects. Element type is per-endpoint.
    - `object` 'row', required
    - `id` string, uuid, required
    - `cells` object, required — Typed cells keyed by column slug. Each cell is polymorphic: `scalar` (input columns), `value` (+ run metadata where present), or `sequence` (a reference to the drafted sequence).
  - `nextCursor` string, nullable, required — Cursor for the next page; `null` means this is the last page.
  - `url` string, required — The path this list was fetched from (query string excluded).
  - `total` integer, required — Total row count for the query's scope (all pages).

## Other responses

- `400` — INVALID_FILTERS / INVALID_SORT / UNKNOWN_COLUMN / VALIDATION_ERROR.
- `404` — TABLE_NOT_FOUND.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)