List mailboxes

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

List mailboxes

get

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

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

orderIdstringRequired

Order resource ID

Example: OR1a2b3c4d5e6f7g

Query parameters

searchstring · max: 255 · nullableOptional

Filter mailboxes whose email address contains the given string

Example: info

sortstring · enum · nullableOptional

Sort mailboxes by field. Prefix with - for descending order.

Default: addressExample: addressPossible values:

pageintegerOptional

Page number

Example: 1

per_pageinteger · max: 100Optional

Number of items per page

Default: 25Example: 25

Responses

200

Success response

application/json

401

Unauthenticated response

application/json

404

Error response

application/json

422

Error response

application/json

500

Error response

application/json

get/api/mail/v1/orders/{orderId}/mailboxes

GET /api/mail/v1/orders/{orderId}/mailboxes HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "AC1a2b3c4d5e6f7g",
      "address": "[e-mail]",
      "status": "active",
      "status_reason": "abuse",
      "protocols": {
        "is_imap_enabled": true,
        "is_pop3_enabled": true,
        "is_smtp_in_enabled": true,
        "is_smtp_out_enabled": true
      },
      "counts": {
        "forwarders": 2,
        "aliases": 1,
        "autoreplies": 0
      },
      "is_catchall": false,
      "usage": {
        "storage_used": 512000,
        "storage_quota": 10485760,
        "messages_used": 1240,
        "messages_quota": 50000,
        "synced_at": "2026-07-22T08:12:00Z"
      },
      "created_at": "2025-03-01T10:00:00Z",
      "updated_at": "2026-07-20T14:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 100
  }
}