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

# List inboxes

`GET /v1/inboxes`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/inboxes`
- Auth: HTTP bearer

Inboxes that are not deleted, newest first.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

A page of inboxes.

- object
  - `data` Inbox[], required
    - `inboxId` string, required
    - `address` string, email, required
    - `domain` string, required
    - `kind` 'shared' | 'custom', required: `shared`: on the platform's shared inbox domain, no DNS needed. `custom`: on a domain of your own.
    - `displayName` string, nullable: Used as the From name on mail sent from this inbox.
    - `status` 'active' | 'paused' | 'deleted', required
    - `securityMode` 'off' | 'tag' | 'hold': Scan received mail for attempts to manipulate an AI agent. `tag`: deliver now, label `security-review` if flagged. `hold`: withhold from the agent (no `email.received`, hidden from reads) until the scan clears it or a project key releases it.
    - `clientId` string, nullable: Your idempotency key from creation, if you passed one.
    - `metadata` object, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable, required: Opaque token. Pass back as `cursor` verbatim to fetch the next page; `null` when there are no more rows.

## Other responses

- `401`: Missing or invalid API key.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)