Get a contact's activity timeline

GET

/v1/contacts/{id}/activities

• Production

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

integer

Query Parameters

limit

integer

default: 50 >= 1 <= 100

Responses

200

Activity timeline (newest first).

object

items

Array<object>

One entry in a contact’s activity timeline.

object

id

integer

type

Note | StageChanged | Assigned | Unassigned | ScoreChanged | TagAdded | TagRemoved | FieldUpdated | Created

string

body

string

nullable

createdAt

string format: date-time

401

Missing or invalid bearer token.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "unauthorized",
  "message": "Invalid bearer principal"
}

403

The API key does not have the required scope for this operation.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "forbidden",
  "message": "scope contacts:write is required"
}

404

The requested resource does not exist or is not owned by the caller.

Standard error envelope for all v1 error responses.

object

error

Machine-readable error code.

string

Allowed values: bad_request not_found conflict unauthorized forbidden rate_limited internal_error

message

Human-readable explanation of the error.

string

details

Optional structured context (field-level validation errors, etc.).

nullable

Example

{
  "error": "not_found",
  "message": "contact not found"
}