---
title: "List Email Addresses"
method: GET
path: "/email_addresses"
tags: ["Email addresses"]
---

# List Email Addresses

`GET /email_addresses`

## Request

- Base URL: `https://api.whop.com/api/v1`
- URL: `https://api.whop.com/api/v1/email_addresses`
- Auth: HTTP bearer

Lists the email addresses of the accounts you can read, and the mailboxes you own. A password is included only for mailboxes you can use.

## Query parameters

- `account_id` string
- `order` 'created_at' | 'address'
- `direction` 'asc' | 'desc'
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

Email address list

- object
  - `data` EmailAddress[], required
    - `account_id` string, required: ID of the account the address belongs to, prefixed `biz_`.
    - `address` string, required: The full address in lowercase, such as support@example.com.
    - `created_at` string, required: When the address was created, as an ISO 8601 timestamp.
    - `domain_id` string, required: ID of the domain the address is on, prefixed `dom_`.
    - `id` string, required: Email address ID, prefixed `emaddr_`.
    - `password` string, nullable, required: The password mail apps sign in to the mailbox with over IMAP and SMTP, using the address as the username. `null` unless you can use the mailbox: you own it, or nobody owns it and you have `email:read` and `email:send`.
    - `updated_at` string, required: When the address was last updated, as an ISO 8601 timestamp.
    - `user_id` string, nullable, required: ID of the team member who owns the mailbox, prefixed `user_`. Only they can read it or send from it. `null` when the whole account shares it.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `401`: Unauthorized

## Changes

> 118 revisions in range; 1 not diffed.

- **2026-10-20** `ac4774bfce4a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/whop/apis/whop-api/changes/email_addresses/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/9046948e0ad1?raw)