---
title: "List mailboxes"
method: GET
path: "/mailboxes"
tags: ["Mailboxes"]
---

# List mailboxes

`GET /mailboxes`

## Request

- Base URL: `https://api.mailforge.ai/public`
- URL: `https://api.mailforge.ai/public/mailboxes`
- Auth: API key in header `Authorization`

Returns all mailboxes belonging to the account.

## Query parameters

- `with_credentials` boolean

## Response `200`

OK

- MailforgeExternalApiDeliveryApiMailboxResponse[]
  - `createdAt` string
  - `credentials` ApiMailboxCredentials
    - `imapHost` string
    - `imapPassword` string
    - `imapPort` integer
    - `imapUsername` string
    - `smtpHost` string
    - `smtpPassword` string
    - `smtpPort` integer
    - `smtpUsername` string
  - `domain` string
  - `domainId` string
  - `email` string
  - `failedReason` string
  - `firstName` string
  - `forwardingEmail` string
  - `forwardingStatus` 'pending' | 'active' | 'failed'
  - `id` string
  - `isPrewarmed` boolean
  - `isTransferred` boolean
  - `lastName` string
  - `nameservers` string[]
  - `signature` string
  - `status` 'draft' | 'active' | 'pending' | 'processing' | 'failed' | 'scheduled_for_deletion' | 'deleting'
  - `updatedAt` string
  - `username` string
  - `workspaceId` string

---

[API](https://skmtc.dev/mailforge/apis/mailforge-api.md) - [All operations](https://skmtc.dev/mailforge/apis/mailforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailforge/apis/mailforge-api/revisions/7d2c137f9fc3?raw)