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

# `inbox_status`

Inbox status and quotas.

The starting point: tells you which space this key works on, whether it is verified, its limits on the shared domain, its permissions, the sending window, and for each inbox (or the one requested) its state, its warm-up, today's quota (sent / remaining), messages in the queue, drafts awaiting approval and the next possible departure. Call it before sending, and when a message is slow to leave.

## Access

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

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `inbox_id` | string | no | One specific inbox (inb_…). Absent: every inbox of the key. |

## Call it

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