Skip to main content
List one data table’s records, each column rendered human-readable. A data table is a company object table (deals, opportunities, accounts, custom objects…); a record is one row. Each record carries its id, the formatted value of every column, and record metadata: name (the table’s name column), source (origin), source_id (external system id), tag (status), active, created_at and last_modified_at. Field values never expose raw ids — amounts carry their currency, dates are YYYY-MM-DD, picklists resolve to labels, user references to emails and linked records to their name. You only see tables and records you have access to; a table you can’t access is reported as not found. When a table reaches you through several shared views, pass view to pick which one. Rows are ordered most-recently-created first for local tables; for integration-synced tables they are ordered alphabetically by record name.

Parameters

Body

data_table
string
required
The table to read, by name (a case- and accent-insensitive substring of the table name) or its ObjectId. Must resolve to exactly one customer-facing (local or integration) table; an ambiguous name is rejected. Use list_data_tables to discover table names.
Free-text filter, matched the same way as the records page — a case- and accent-insensitive substring of the record’s name and external id. Omitted returns the table’s records unfiltered. AND-ed with the applied view’s row filter.
view
string
View to apply, by name (case- and accent-insensitive substring) or ObjectId — narrows the records to that view. Required only when the table reaches you through several shared views; otherwise omit it to read the whole table.
limit
integer
Page size, between 1 and 250. Defaults to 50.
offset
integer
Row offset into the result set — the number of rows to skip before this page. Pass the next_offset returned by the previous call, or None for the first page.

Response

Body

data_table
object
records
object[]
next_offset
integer