Skip to main content
GET
Get table stats

Authorizations

X-API-Key
string
header
required

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.