List inboxes - Drin

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

string

Narrow the list to inboxes on a single domain. Omit to return all inboxes for the project.

Request

curl "https://api.drin.run/v1/inboxes?domainId=dom_01HZ8K3M9P" \
  -H "Authorization: Bearer $DRIN_API_KEY"

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);
}

Response

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

{
  "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"
    }
  ]
}