---
title: "Get mailbox"
method: GET
path: "/mailboxes/{mailboxID}"
tags: ["Mailboxes"]
---

# Get mailbox

`GET /mailboxes/{mailboxID}`

## Request

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

Returns a single mailbox by ID.

## Path parameters

- `mailboxID` string, required

## 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

## Other responses

- `404`: Mailbox not found

---

[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)