List record activities

Returns the activity feed for a record: one activity_event resource per change event, newest first. Each page covers at most 90 days back from the cursor, or from the record’s latest activity on the first page, and holds at most page[limit] events. A page can hold fewer events, even none, while links.next is set, so follow links.next until it is null. Events that share an aggKey and are adjacent can be shown as one activity.

Authorization

Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

object*string

The object type: a built-in entity (person, company, deal, …) or a custom object (c_*).

record*string

The unique ID of the record.

Query Parameters

page?

Cursor pagination, e.g. page[cursor]=...&page[limit]=100.

Default

{  "limit": 50}

filter?

Header Parameters

clarify-version?string

The API version for this request. Send 2026-10 to get the behavior documented here. Omit it to use your API key's version, which this header can raise but not lower.

Response Body

`application/json`

curl -X GET "https://example.com/workspaces/string/objects/string/records/string/activities" \  -H "clarify-version: 2026-10"

{  "links": {    "next": "https://api.clarify.ai/v1/workspaces/acme/objects/person/records/5f8b7d2e-9c4a-4e1b-8f3d-2a6c9e0b4d71/activities?page%5Bcursor%5D=1769967900000000%3A%3Ab4f1a7c2-8d3e-4f6a-9b2c-1e5d7a3f9c40&page%5Blimit%5D=50"  },  "data": [    {      "type": "activity_event",      "id": "b4f1a7c2-8d3e-4f6a-9b2c-1e5d7a3f9c40",      "attributes": {        "event": {          "_id": "b4f1a7c2-8d3e-4f6a-9b2c-1e5d7a3f9c40",          "_created_at": "2026-02-01T17:45:00.000Z",          "type": "clarify:update",          "actor": {            "_id": "7d4e2f9a-1b3c-4d5e-8f6a-9c0b2d4e6f81",            "anonymous_id": null,            "entity": "user",            "source_id": null          },          "object": {            "_id": "5f8b7d2e-9c4a-4e1b-8f3d-2a6c9e0b4d71",            "anonymous_id": null,            "entity": "person",            "diff": [              {                "op": "update",                "path": [                  "job_title"                ],                "val": "VP of Marketing",                "oldVal": "Director of Marketing"              }            ]          }        },        "aggKey": "person:5f8b7d2e-9c4a-4e1b-8f3d-2a6c9e0b4d71:clarify:update"      }    }  ]}