> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `list_events`

Activity log.

Reads the space's activity log: who did what, and when (your agent, you from your assistant, or the service). Without an object, the requested day (today by default, Paris time). With an object (an inbox, a thread, a message, a campaign, an audience, a contact or a domain), everything that touches it, newest first. Each line has a sentence in French, its author (actor: kind agent, human or service; you is true when it is the reading access) and the objects it touches. Read-only.

## Access

- **Key**: an Escouade Mail key with `read`.
- **Space**: any space, verified or not.
- **Changes nothing**: yes, it only reads.
- **Safe to replay**: yes.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `day` | string | no | A Paris day, YYYY-MM-DD. Absent: today, unless an object is given (then its whole history). |
| `inbox_id` | string | no | An inbox (inb_…). |
| `thread_id` | string | no | A thread (thr_…). |
| `message_id` | string | no | A message (msg_…). |
| `campaign_id` | string | no | A campaign (cmp_…). |
| `audience_id` | string | no | An audience (aud_…). |
| `contact` | string | no | An address: its threads, its record, its blocks. |
| `domain` | string | no | A domain: its checks and its inboxes. |
| `cursor` | string | no | Cursor of the next page: the next_cursor value from the previous call. |
| `limit` | integer | no | Number of lines returned. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/list_events \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{}'
```

The full page in French, with the response fields and every refusal the tool can return: [/mail/docs/reference/list_events](https://escouade.io/mail/docs/reference/list_events).