Skip to the documentation
API

List addresses

The addresses that exist on the domain, alphabetically, a page at a time with `limit` and `cursor`.

GET/domains/{id}/addresses

Runs the real call on your workspace.

GET /domains/{id}/addresses

The addresses that exist on the domain, alphabetically, a page at a time with limit and cursor.

Example

Needs domains:read.

curl
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses?limit=50" -H "$AUTH"
Response
{  "object": "list",  "data": [    {      "object": "address",      "id": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18",      "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f",      "address": "[email protected]",      "localPart": "billing",      "label": "Invoices",      "enabled": true,      "destination": "mailbox",      "lastReceivedAt": null,      "createdAt": "2026-09-25T10:00:00.000Z",      "updatedAt": "2026-09-25T10:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

An address removed with DELETE is not listed. The catch-all is not an address, and whether it is on is receiving.catchAll on the domain.

Reference