v2
latestOpenAPI 3.1.02026-07-26143251806.6 KBsmart-tables
List Rows
List rows in a sheet, each containing a map of column_id to cell. For prompt-template column cells, each cell can include a request_metrics object with price, latency, and token usage when available. Pass include_columns=true on the first page to receive column metadata alongside rows. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.
get/api/public/v2/tables/{table_id}/sheets/{sheet_id}/rows
Path parameters
table_idstring uuid required
sheet_idstring uuid required
Query parameters
include_system_columnsboolean
When true, include system-managed metadata columns such as price and latency columns for prompt-template outputs.
include_execution_metadata_aggregatesboolean
When true, include sheet-level and per-column aggregates for execution metrics such as price and latency.
cursorstring
limitinteger
order'asc' | 'desc'
include_columnsboolean
Include column metadata in the response. Defaults to true on the first page.
include_row_countboolean
Response
List of rows