Per-contact activity timeline

Search Documentation

Search across all developer documentation

activities

Per-contact activity timeline

GET /v1/contacts/{id}/activities
Auth required api.activities.view

Returns one contact's activities, newest first, cursor-paginated. 404 not_found when the id is not a contact in this org. Filters: name, from/to (default last 30 days, capped by plan retention).

Path parameters

id string<uuid> required

Resource UUID. An unparseable id reads as a clean 404 not_found.

Query parameters

from string<date-time> optional

Window start (RFC 3339). Defaults to 30 days ago.

to string<date-time> optional

Window end (RFC 3339). Defaults to now.

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

name string optional

Exact activity name to filter by.

Responses

200 Cursor-paginated per-contact timeline application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json