Skip to main content
GET
List records for a view

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

Org ID

view_id
string
required

View ID

Query Parameters

status
enum<string>

Filter by visibility. ACTIVE excludes archived (default), ARCHIVED returns only archived, ALL returns both.

Available options:
ACTIVE,
ARCHIVED,
ALL

Search query

Maximum string length: 256
group
string

Board only — the group key whose records to return. Use a key from GET /views/:view_id/groups (an enum option value, or '__unmatched__' for the unmatched group). Required for kind='board'.

Maximum string length: 1024
date_from
string<date-time> | null

Calendar / Timeline — visible window start. Records whose date axis falls before this are excluded. ISO 8601.

date_to
string<date-time> | null

Calendar / Timeline — visible window end. Records whose date axis falls after this are excluded. ISO 8601.

date_missing
boolean

Timeline only. Return just the records whose start-date axis is empty (the "No date" bucket). Takes precedence over date_from / date_to.

page
number

Page number

take
number

Number of items to take

next
string

Next page token (Only used on special endpoints)

Response

200 - application/json
id
string
required
table_id
string
required
icon
required

The picked icon. Null falls back to the table icon.

archived
boolean
required

Whether the record is archived.

position
string | null
required

The position of the record in the view.

updated_at
string<date-time> | null
required

Last modification time. Total-orders concurrent updates so caches can keep the newest copy.

values
object[]
required

The values of the record.