---
title: "List mailboxes"
method: GET
path: "/api/mail/v1/orders/{orderId}/mailboxes"
tags: ["Mail: Mailboxes"]
---

# List mailboxes

`GET /api/mail/v1/orders/{orderId}/mailboxes`

Retrieve a paginated list of mailboxes belonging to a mail order.

Use this endpoint to monitor mailboxes of your mail service, including
their status, enabled protocols, attached resource counts, and
periodically synced usage numbers (usage may lag behind live values).

## Path parameters

- `orderId` string, required

## Query parameters

- `search` string, nullable
- `sort` 'address' | '-address', nullable
- `page` integer
- `per_page` integer

## Response `200`

Success response

- object
  - `data` MailV1MailboxesMailboxResource[] — Array of [`Mail.V1.Mailboxes.MailboxResource`](#model/mailv1mailboxesmailboxresource)
    - `id` string — Mailbox resource ID
    - `address` string — Email address of the mailbox
    - `status` 'active' | 'suspended' — Mailbox status
    - `status_reason` string, nullable — Reason the mailbox was suspended
    - `protocols` MailV1MailboxesMailboxProtocolsResource
      - `is_imap_enabled` boolean
      - `is_pop3_enabled` boolean
      - `is_smtp_in_enabled` boolean
      - `is_smtp_out_enabled` boolean
    - `counts` MailV1MailboxesMailboxCountsResource
      - `forwarders` integer — Number of attached forwarders
      - `aliases` integer — Number of attached aliases
      - `autoreplies` integer — Number of attached auto-replies
    - `is_catchall` boolean — Whether the mailbox is the catch-all destination for its domain
    - `usage` MailV1MailboxesMailboxUsageResource — Periodically synced usage numbers (may lag behind live values)
      - `storage_used` integer — Storage used in kilobytes
      - `storage_quota` integer — Storage quota in kilobytes
      - `messages_used` integer
      - `messages_quota` integer
      - `synced_at` string, date-time, nullable — When the usage numbers were last synced; null if never synced
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `404` — Error response
- `422` — Error response
- `500` — Error response

---

[API](https://skmtc.dev/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.dev/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/53ccee45e5eb/schema)