> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drin.run/llms.txt
> Use this file to discover all available pages before exploring further.

# List inboxes

> GET /v1/inboxes — list the receive addresses for the project, optionally narrowed to one domain.

List every receive address the project owns. Pass a domain id to narrow the list to a single receiving domain.

**`GET /v1/inboxes`**

Returns the inboxes for the project as a flat array under `data`. Use the optional `domainId` filter to build a per-domain inbox picker.

## Query parameters

<ParamField query="domainId" type="string">
  Narrow the list to inboxes on a single domain. Omit to return all inboxes for the project.
</ParamField>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.drin.run/v1/inboxes?domainId=dom_01HZ8K3M9P" \
    -H "Authorization: Bearer $DRIN_API_KEY"
  ```

  ```typescript Node.js theme={null}
  import { DrinClient } from "@drin00/sdk";

  const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

  const inboxes = await drin.inboxes.list({ domainId: "dom_01HZ8K3M9P" });

  for (const inbox of inboxes) {
    console.log(inbox.address, inbox.type);
  }
  ```
</CodeGroup>

## Response

`200 OK` — the inboxes for the sender, each carrying its `address`, owning `domainId`, and `type` (`sending` or `agent`).

```json theme={null}
{
  "data": [
    {
      "id": "inb_01HZ9C7R2K",
      "senderId": "snd_01HZ0A1B2C",
      "domainId": "dom_01HZ8K3M9P",
      "address": "support@acme.com",
      "displayName": "Acme Support",
      "type": "sending",
      "createdAt": "2026-06-02T09:12:00Z"
    }
  ]
}
```