---
title: "Get mailbox by ID"
method: GET
path: "/api/v1/mailboxes/{mailboxId}"
tags: ["Mailboxes"]
---

# Get mailbox by ID

`GET /api/v1/mailboxes/{mailboxId}`

## Request

- Base URL: `https://api.aerosend.io`
- URL: `https://api.aerosend.io/api/v1/mailboxes/{mailboxId}`
- Auth: API key in header `X-API-Key`

Returns detailed information about a specific mailbox.

Set `include_credentials=true` to get SMTP and IMAP connection details.

## Path parameters

- `mailboxId` integer, required

## Query parameters

- `include_credentials` boolean

## Response `200`

Successfully retrieved mailbox

- MailboxResponse
  - `success` boolean: Success flag
  - `data` Mailbox: Mailbox details
    - `id` integer: Mailbox ID
    - `email` string: Email address
    - `first_name` string: First name
    - `last_name` string: Last name
    - `status` string: Mailbox status
    - `created_at` string: Creation timestamp
    - `updated_at` string: Last modification timestamp
    - `domain_id` integer: Domain ID this mailbox belongs to
    - `domain` string: Domain name
    - `credentials` Credentials: SMTP and IMAP credentials for mailbox
      - `smtp` ServerConfig: Mail server configuration
        - `host` string: Server hostname
        - `port` integer: Server port
        - `username` string: Username (email address)
        - `password` string: Password for authentication
        - `security` string: Security protocol
      - `imap` ServerConfig: Mail server configuration
        - `host` string: Server hostname
        - `port` integer: Server port
        - `username` string: Username (email address)
        - `password` string: Password for authentication
        - `security` string: Security protocol
    - `tags` Tag[]: Tags assigned to this mailbox
      - `id` integer: Tag ID
      - `name` string: Normalized tag name
      - `display_name` string: Display name
      - `color` string: Tag color in hex
      - `status` string: Tag status
      - `domain_count` integer: Number of domains with this tag
      - `mailbox_count` integer: Number of mailboxes with this tag
      - `created_at` string: Creation timestamp
      - `updated_at` string: Last update timestamp
  - `timestamp` string: Response timestamp

## Other responses

- `401`: Unauthorized - Invalid or expired API key
- `404`: Mailbox not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/aerosend/apis/aerosend-developer-api.md) · [All operations](https://skmtc.dev/aerosend/apis/aerosend-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aerosend/apis/aerosend-developer-api/revisions/9828eeb89b1f?raw)