> 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_threads`

List conversations.

The mailbox: received exchanges and individual messages, newest first. Campaign sends on their own stay in campaign_history; as soon as a reply arrives, the conversation shows here with its context. Statuses: open, replied, bounced, unsubscribed, closed. With unanswered = true: threads waiting for your reply, new received messages (open) included. Cursor pagination.

## 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 |
|---|---|---|---|
| `inbox_id` | string | no | A single inbox (inb_…). |
| `status` | one of `open`, `replied`, `bounced`, `unsubscribed`, `closed` | no | A single status. |
| `unanswered` | boolean | no | true: only threads whose last message is a received e-mail that nothing has been written back to yet (a reply, or a first e-mail). |
| `archived` | boolean | no | true: archives; false: conversations not archived. |
| `unread` | boolean | no | true: unread received messages; false: read ones. |
| `label` | string | no | Exact tag. |
| `folder` | one of `received`, `sent`, `drafts` | no | A folder of the mailbox, as the workbench shows it. |
| `since` | string | no | Threads active since this date. |
| `query` | string | no | Search: part of the correspondent's address, of their name or of the subject. |
| `cursor` | string | no | Cursor of the next page: the next_cursor value from the previous call. |
| `limit` | integer | no | Number of items returned (20 by default). |

## Call it

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