Per-contact activity summary by name

Search Documentation

Search across all developer documentation

activities

Per-contact activity summary by name

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

Returns one row per activity name the contact has ever recorded: total count, count over the last 30 days, and first/last occurrence. Served from a precomputed rollup — cheap to poll. 404 not_found when the handle names no contact in this org.

Path parameters

id string required

The contact's UUID, its external_id, or its email address (percent-encoded) — the same three handles the contact= filter on GET /v1/activities accepts. Unknown handles read as 404 not_found.

Responses

Errors follow the RFC 7807 problem format — see the error reference.

200 Per-name activity summary application/json
data array<object> required

Each entry in data:

name string required
count_total integer<int64> required
count_30d integer<int64> required
first_at string<date-time> required
last_at string<date-time> required
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
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