---
title: "Read events"
description: "The events one contact did, newest first, and the event names the workspace has sent, for choosing one in a trigger."
url: "https://openemail.uk/docs/api/automations/event-history"
area: "API"
category: "Mailbox"
---

# Read events

The events one contact did, newest first, and the event names the workspace has sent, for choosing one in a trigger.

`GET /contacts/{email}/events`

**Also documents:** `GET /events/names`

## GET /contacts/{email}/events

The events one contact did, newest first, and the event names the workspace has sent, for choosing one in a trigger.

## Example

A contact’s events need `contacts:read`, and the names need `automations:read`. The contact is named by address or by id. `name` narrows the list to one event, and `limit` goes up to 200 and defaults to 50.

**curl**

```
curl "$OE/contacts/ana@example.com/events?name=order.placed" -H "$AUTH"
curl "$OE/events/names" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "contact_event",
      "id": "cev_6a1d9f3c8b2e40a75d9c1e38",
      "contactId": "5b0e7c1a-2f4d-4c8b-9a36-1e7d0c5f8b24",
      "email": "ana@example.com",
      "name": "order.placed",
      "properties": { "orderId": "A-1042", "total": 59 },
      "occurredAt": "2026-10-11T08:02:03.000Z",
      "mode": "live",
      "createdAt": "2026-10-11T08:02:03.412Z"
    }],
  "hasMore": false,
  "nextCursor": null
}
```

> Events older than 90 days are deleted, so a branch can look back 90 days at most.

> `GET /events/names` answers a list of `{ "object": "contact_event_name", "name": "order.placed" }`, up to 100 names in alphabetical order.

## Reference

- [`GET /contacts/{email}/events`](https://openemail.uk/docs/api/reference/events#get-contacts-email-events): full reference
- [`GET /events/names`](https://openemail.uk/docs/api/reference/events#get-events-names): full reference