List record activities

Returns the activity feed for a record: a paginated, reverse-chronological list of change events (field updates, comments, relationship changes) grouped into activities. Each activity bundles one or more related events. meta.total_records can be a lower bound, so follow links.next to page.

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?

Offset pagination, e.g. page[offset]=0&page[limit]=100.

Default

{  "offset": 0,  "limit": 500}

sortOrder?

Sort order, e.g. sortOrder[column]=_created_at&sortOrder[dir]=DESC.

Response Body

`application/json`

curl -X GET "https://example.com/workspaces/string/objects/string/records/string/activities"

{  "links": {    "next": null,    "prev": null  },  "meta": {    "total_records": 1,    "total_pages": 1,    "offset": 0,    "limit": 500  },  "data": [    {      "type": "activity",      "id": "f2c8e4a1-6b9d-4e7f-8a3c-0d5b2f7e1a94",      "attributes": {        "_id": "f2c8e4a1-6b9d-4e7f-8a3c-0d5b2f7e1a94",        "_created_at": "2026-02-01T17:45:00.000Z",        "aggKey": "person:5f8b7d2e-9c4a-4e1b-8f3d-2a6c9e0b4d71:clarify:update",        "data": [          {            "_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"                }              ]            }          }        ]      }    }  ]}