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 against your workspace, with your own key.

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,      "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.

Your inbox,
on your own terms.

Email infrastructure for businesses, AI, agents and personal email. Built for scale, privacy and control. Everything email should have had from day one.

OpenEmail

Email infrastructure for businesses, AI, agents and personal email. Built for scale, privacy and control. Everything email should have had from day one.

© 2026 OpenEmail. All rights reserved.