List activities

Retrieve a paginated list of deal activities, filterable by type, activity status, deal status, origin, stage, assigned user, deal, free text, tags, and a date range. Requires the ACTIVITIES_API feature flag and an API key with the activities:read scope.

Consistency note: listing is served from the search index and is eventually consistent (typically seconds behind writes). GET /v2/activities/:id reads from the primary database and is always fresh — poll that endpoint instead of the list if you need to confirm a just-written change.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Comma-separated list of activity types to filter by (CALL, MAIL, SCHEDULE, TASK, MEETING, WHATSAPP, INSTAGRAM).

string

Comma-separated list of activity statuses to filter by (DELAYED, ON_TIME, COMPLETE, IGNORED).

string

Comma-separated list of deal statuses to filter by (OPEN, WON, LOST).

string

Comma-separated list of origin UUIDs to filter by.

string

Comma-separated list of stage UUIDs to filter by.

uuid

Filter by the deal's assigned user (single UUID).

uuid

Filter by a single deal UUID.

string

Free-text search across the activity title and content.

string

Comma-separated list of tag UUIDs. An activity matches when its deal has any of these tags.

string

Comma-separated list of tag UUIDs to exclude. An activity is excluded when its deal has any of these tags.

string
enum
Defaults to due

Which date field date_start/date_end filter against. due (default) is the activity's due date, created is when the activity was created, won/lost are the deal's won_at/lost_at.

Allowed:
date-time

Inclusive start of the date range (ISO 8601), applied to the field selected by date_type.

date-time

Inclusive end of the date range (ISO 8601), applied to the field selected by date_type.

integer
1 to 200
Defaults to 200

Max number of rows returned

integer
≥ 1
Defaults to 1

Select the page of the result

Headers
string
required

API Token

Responses

401

Authentication error - invalid or missing api-token

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json