> 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.

# `activity_report`

Today's summary and report.

Tells you in one call what is waiting for a human decision (drafts to approve, received messages without a reply, domains to verify, suspended inboxes) and what the inboxes sent and received: today, or over the last seven days with a breakdown by day. Call it when your human asks how their space is doing, or for a report. Sends are the ones today's quota counts; replies, bounces, unsubscribes and complaints come from the log: nothing is estimated.

## Access

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

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `period` | one of `today`, `week` | no | today: the current day (Paris time). week: the last seven days, today included. |
| `inbox_id` | string | no | A single inbox (inb_…). Absent: every inbox of the key. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/activity_report \
  -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/activity_report](https://escouade.io/mail/docs/reference/activity_report).