Docs
DashboardGet API key
API · inboxes

List inboxes

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.

01 Query parameters

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

02 Request

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

03 Response

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

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