Skip to main content
GET
Get table stats

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

table_id
string<uuid>
required

Response

Successful Response

Aggregate stats for one table, composed from three downward reads.

active_run
TableRunReadSchema · object | null
required

The newest active run, when one exists.

at_row_cap
boolean
required

Whether the table has reached its row cap.

columns_by_kind
Columns By Kind · object
required

Number of columns per column kind (manual/formula).

failed_cells
integer
required

Cells currently carrying an evaluation error.

failed_cells_by_column
Failed Cells By Column · object
required

Errored cells per column ID. A column with no failures is absent — read absence as zero. What the column header's error badge shows.

filled_cells_by_column
Filled Cells By Column · object
required

Cells holding a stored value, per column ID. A column with no filled cells is absent — read absence as zero. How much of the column has DATA in it, which is not how much of it is DONE — for that, and for the breakdown behind it, read cell_settlement_by_column.

row_count
integer
required
cell_settlement_by_column
Cell Settlement By Column · object

How each column's cells ended, per column ID. A column with no cells is absent — read absence as zero across every figure.

The completeness read. filled_cells_by_column and failed_cells_by_column are both projections of this and are kept only so an existing API-key client does not break.

last_run_at_by_column
Last Run At By Column · object

When each column last produced a value. Derived from its newest computed cell — a column absent here has never run. Not the column's updated_at, which moves when it is merely renamed.