Skip to main content
GET
List object records
Required scopes: data_objects.read

Authorizations

Authorization
string
header
required

Use Authorization: Bearer rk_live_....

Path Parameters

object_id
string
required

Object id, system key such as system:leads, or slug from discovery.

Required string length: 1 - 200

Query Parameters

Maximum string length: 200
cursor
string

Opaque cursor returned by list/export responses. Send it back unchanged; malformed cursors return 400.

Maximum string length: 500
limit
integer
default:50
Required range: 1 <= x <= 100
view_id
string
Maximum string length: 200
filters_json
string

JSON text of an ObjectFilterQuery. Send an array of filters that must all match, or an object with filters and an advanced filter whose rules join with and or or. Each filter names a field in fieldId by its id or its key, as GET /api/v1/objects/{object_id} lists them. Operators: is_empty and is_not_empty take no value. equals, not_equals, contains, and has_reached take value. any_of takes an array of strings. greater_than and less_than take a number, and between takes value and valueTo. before and after take a date (YYYY-MM-DD) or an ISO 8601 datetime and exclude the day they name. within_range takes value and valueTo and includes both days. A bare date covers the whole UTC day. A datetime with an offset is converted to UTC. Without filters_json the read applies the filters of view_id, or none. Invalid JSON, an unknown operator, a missing value, an unknown field, or a field that cannot be filtered returns 400 with the path of each issue. Example, records created in October 2026: [{"fieldId":"created_at","operator":"within_range","value":"2026-10-01","valueTo":"2026-10-31"}]

Maximum string length: 20000
sorts_json
string

JSON text of an array of ObjectSort. Each sort names a field in fieldId by its id or its key. Without sorts_json the read uses the sort of view_id, or created_at, newest first. Only one sort on created_at or updated_at keeps the keyset cursor. Any other sort pages by number. Invalid JSON, an unknown field, or a formula field returns 400. Example, oldest records first: [{"fieldId":"created_at","direction":"asc"}]

Maximum string length: 20000

Response

Record page.

records
object[]
required
pagination
object
required