Contacts::Event

List Contact Events

Changed on

Read the Event rows used by the contact Activity tab. MessageHub conversation rows are excluded. Numeric and public IDs are accepted. Ordered by created_at then id (ascending by default, desc for latest activity). Pagination-Next is the row id. sort_property is not supported (422). Unfiltered or multi-type reads are refused with 422 above 50,000 events; pass a single filter[type] key to read such a contact.

get/contacts/{contact_id}/events

Request

Path parameters

contact_idstring required

Query parameters

afterstring

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

per_pageinteger

Records per page. Defaults to 20; raise it up to 100 for bulk reads. A larger value returns 100 records. Zero, a negative or a non-integer value is a 422. The Link next-page URL keeps the value, so a client following it keeps the page size. More in our guides.

sort_order'asc' | 'desc'

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

typestring

Comma-separated event type keys. Unknown keys match no events.

{
  "type": "$order.successful_purchase,$contact.note"
}

Response

OK

idinteger
public_idstring
contact_idinteger
type_keystring nullable

Event type key.

type_labelstring nullable

Label of the resolved event type.

occurred_atstring date-time

Tracked occurrence time, falling back to created_at; can differ from list order.

actor_idinteger nullable

User ID, resolvable through GET /api/v2/users/{id}; null for contact or system activity.

dataunknown
created_atstring date-time
order_idinteger nullable
orders_transaction_idinteger nullable
product_idinteger nullable
workflow_idinteger nullable
workflows_step_idinteger nullable
broadcast_idinteger nullable
course_idinteger nullable
courses_section_idinteger nullable
courses_lesson_idinteger nullable
page_idinteger nullable
visit_idinteger nullable
contacts_tag_idinteger nullable
sales_opportunity_idinteger nullable
calendar_event_idinteger nullable
url_redirect_idinteger nullable

Example response

[
  {
    "id": 912345678,
    "public_id": "AbCdEf",
    "contact_id": 123,
    "type_key": "$contact.note",
    "type_label": "Contact Note",
    "occurred_at": "2026-10-12T14:03:00.000Z",
    "actor_id": null,
    "data": {
      "note": "Called about the refund"
    },
    "created_at": "2026-10-13T09:15:22.000Z",
    "order_id": null,
    "orders_transaction_id": null,
    "product_id": null,
    "workflow_id": null,
    "workflows_step_id": null,
    "broadcast_id": null,
    "course_id": null,
    "courses_section_id": null,
    "courses_lesson_id": null,
    "page_id": null,
    "visit_id": null,
    "contacts_tag_id": null,
    "sales_opportunity_id": null,
    "calendar_event_id": null,
    "url_redirect_id": null
  }
]

Changes