# Get a single mailbox by ID (https://developer.godaddy.com/en/docs/references/rest/email/get-mailbox)

---
title: Get a single mailbox by ID
description: Returns the current state of a single mailbox.
full: true
---

Full description

\| Returns the current state of a single mailbox. Poll this endpoint after POST /mailboxes until status reaches COMPLETED or FAILED.

## GET /mailboxes/{mailboxId}

Get a single mailbox by ID

Returns the current state of a single mailbox. Poll this endpoint
after POST /mailboxes until status reaches COMPLETED or FAILED.


### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `mailboxId` | string <uuid> | yes | The mailbox identifier returned from POST /mailboxes. |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | string <uuid> | no | Optional client-generated request correlation identifier. Propagated across services and echoed in the X-Request-Id response header. |

### Responses

**200** — The requested mailbox.

Content-Type: `application/json`

```json
{
  "mailboxId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "emailAddress": "jane.smith@example.com",
  "mailboxType": "TITAN",
  "firstName": "Jane",
  "lastName": "Smith",
  "displayName": "Jane Smith",
  "status": "COMPLETED",
  "createdAt": "2024-03-15T10:30:00Z",
  "updatedAt": "2024-06-01T08:00:00Z",
  "links": [
    {
      "rel": "self",
      "href": "/mailboxes/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  ]
}
```

Schema:

- schema reference: `#/components/schemas/Mailbox`

**400** — Malformed request syntax, missing required field, or invalid field value.

Content-Type: `application/json`

```json
{
  "name": "INVALID_INPUT",
  "correlationId": "req-abc-123",
  "message": "The provided request is invalid.",
  "details": [
    {
      "field": "/username",
      "issue": "PATTERN_VIOLATION",
      "location": "body",
      "description": "Username must contain only letters, digits, dots, underscores, hyphens, and plus signs.\n"
    }
  ]
}
```

Schema:

- schema reference: `#/components/schemas/Error`

**401** — Authentication credentials are missing or invalid.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**403** — Authenticated identity is not authorized to perform this operation.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**404** — The requested resource was not found.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**429** — Too many requests — rate limit exceeded.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**Security:** requires `bearerAuth`.