---
title: "List addresses"
description: "The addresses that exist on the domain, alphabetically, a page at a time with `limit` and `cursor`."
url: "https://openemail.uk/docs/api/domains/addresses/list"
area: "API"
category: "Mailbox"
---

# List addresses

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

`GET /domains/{id}/addresses`

## 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": "billing@acme.com",
      "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.