---
title: "List all email addresses"
method: GET
path: "/api/e2/email-addresses"
tags: ["Email Addresses"]
---

# List all email addresses

`GET /api/e2/email-addresses`

Get paginated list of email addresses for authenticated user with optional filtering by domain, active status, and receipt rule configuration

## Query parameters

- `limit` union
  - string, integer
  - integer
- `offset` union
  - string, integer
  - integer
- `domainId` string
- `isActive` 'true' | 'false'
- `isReceiptRuleConfigured` 'true' | 'false'

## Response `200`

Response for status 200

- object
  - `data` object[], required
    - `id` string, required
    - `address` string, required
    - `domainId` string, required
    - `webhookId` string, nullable, required
    - `endpointId` string, nullable, required
    - `isActive` boolean, required
    - `isReceiptRuleConfigured` boolean, required
    - `receiptRuleName` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `userId` string, required
    - `domain` object, required
      - `id` string, required
      - `name` string, required
      - `status` string, required
    - `routing` object, required
      - `type` 'webhook' | 'endpoint' | 'none', required
      - `id` string, nullable, required
      - `name` string, nullable, required
      - `config` unknown
      - `isActive` boolean, required
  - `pagination` object, required
    - `limit` number, required
    - `offset` number, required
    - `total` number, required
    - `hasMore` boolean, required

## Other responses

- `401` — Response for status 401
- `500` — Response for status 500

## Changes

- **2025-12-08** `3a201e697c78` — 2 breaking, 2 info
  - `query` request parameter `limit` list-of-types was narrowed by removing types `number`
  - `query` request parameter `offset` list-of-types was narrowed by removing types `number`
  - for the `query` request parameter `limit`, the type/format was generalized from `number`/`` to ``/``
  - for the `query` request parameter `offset`, the type/format was generalized from `number`/`` to ``/``
- **2025-12-03** `dbb1412c90a4` — 2 info
  - response property `data/items/createdAt` list-of-types was narrowed by removing types `Date and number` from media type `application/json` of response `200`
  - response property `data/items/updatedAt` list-of-types was narrowed by removing types `Date and number` from media type `application/json` of response `200`

[Change history](https://skmtc.dev/inboundemail/apis/inbound-email-api/changes/api/e2/email-addresses/get.md)

---

[API](https://skmtc.dev/inboundemail/apis/inbound-email-api.md) · [All operations](https://skmtc.dev/inboundemail/apis/inbound-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inboundemail/inbound-email-api/revisions/04a8a5e5040d/schema)