Get contact history
The contact timeline: emails sent and read, forms submitted, imports, segment and campaign changes.
GET https://cotlet.dev/api/v1/mautic/contacts/{contact_id}/history
read
Returns the events of the contact History, newest first, with the event label Mautic shows (Email Sent, Email Read, Form Submitted, Imported, Contact Created By Source, Do Not Contact and others). include and exclude work like the source filters on the page. Pass next_cursor back as cursor for older events.
Parameters
| Name | Type | Description |
|---|---|---|
| contact_id integer required | integer | Contact ID from list_contacts. |
| include string | string | Event source to include, as in Include events by source. |
| exclude string | string | Event source to leave out, as in Exclude events by source. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/mautic/contacts/1/history \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("mautic", "get_contact_history", {"contact_id":1})const result = await cotlet.call('mautic', 'get_contact_history', {"contact_id":1});cotlet call mautic get_contact_history --data '{"contact_id":1}'Example response
{
"events": [
{
"event": "Email Read",
"detail": "October newsletter",
"at": "2026-10-21T09:14:00Z"
},
{
"event": "Segment Membership Change",
"detail": "Added to webinar-leads",
"at": "2026-10-14T11:30:00Z"
},
{
"event": "Imported",
"detail": "webinar-signups.csv",
"at": "2026-10-14T11:29:00Z"
}
],
"next_cursor": null
}