---
title: "List inboxes"
method: GET
path: "/v1/inboxes"
tags: ["inboxes"]
---

# List inboxes

`GET /v1/inboxes`

## Request

- Base URL: `https://cherami.to`
- URL: `https://cherami.to/v1/inboxes`
- Auth: HTTP bearer

Lists every inbox on the account in one response, without pagination. `inbox_allowance.remaining` is how many more you can create.

## Response `200`

Success.

- InboxList
  - `inboxes` Inbox[], required
    - `id` string, required: Cherami resource ID.
    - `local_part` string, required
    - `address` string, required
    - `name` string, nullable, required
    - `sender_name` string, nullable, required
    - `created_at` string, date-time, required: UTC timestamp with milliseconds.
  - `inbox_limit` integer, required: Most inboxes the account can have; the same as inbox_allowance.allowance.
  - `inbox_allowance` InboxAllowance, required
    - `allowance` integer, required
    - `used` integer, required
    - `remaining` integer, required
    - `unit` 'inbox_slots', required

## Other responses

- `401`: `unauthorized`: Send a valid API key as `Authorization: Bearer <key>`. If the key stopped working, get a new one through [recovery](https://cherami.to/docs/guides/recovery).
- `404`: `not_found`: The resource does not exist or does not belong to this account. A reply or forward source must also be in the sending inbox.
- `500`: `internal_error`: The operation failed. Retry a read; after a write the change may have happened, so recover as [retry by operation](https://cherami.to/docs/api/errors#retry-by-operation) describes.

---

[API](https://skmtc.dev/cherami/apis/cherami-http-api.md) · [All operations](https://skmtc.dev/cherami/apis/cherami-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cherami/apis/cherami-http-api/revisions/7bd993d538af?raw)