Skip to main content
GET
List activities

Authorizations

Authorization
string
header
required

A workspace API token (sk_live_...) or an OAuth access token (oat_live_...). Create workspace tokens in Settings > API. Send either as Authorization: Bearer <token>.

Query Parameters

record_id
string | null

Only activities on this contact, organization or deal. Id of a contact, organization or deal. The prefix names the kind of record.

Pattern: ^(con|org|deal)_[0-9a-f]{32}$
Example:

"con_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

status
enum<string> | null
Available options:
open,
completed,
canceled,
conflict,
suggested
type
enum<string> | null
Available options:
task,
call,
email,
meeting,
follow_up,
resume_conversation
due_before
string<date-time> | null

Only activities due at or before this instant.

due_after
string<date-time> | null

Only activities due at or after this instant.

limit
integer
default:50

Items per page (max 200).

Required range: 1 <= x <= 200
cursor
string | null

Opaque cursor from a previous response's links.next.

Response

Successful Response

A page of activities, latest due_at first.

data
Activity · object[]
required
meta
PageMeta · object
required