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

# List aliases

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

Retrieve a paginated list of aliases across all mailboxes of a mail
order.

## Path parameters

- `orderId` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Success response

- object
  - `data` MailV1AliasesAliasResource[] — Array of [`Mail.V1.Aliases.AliasResource`](#model/mailv1aliasesaliasresource)
    - `id` string — Unique alias identifier
    - `address` string — Email address of the alias
    - `mailbox` MailV1AliasesAliasMailboxResource
      - `id` string — Mailbox resource ID
      - `address` string
    - `is_active` boolean — Whether the alias is active and not suspended
    - `created_at` string, date-time, nullable
    - `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

## Changes

> 88 revisions in range; 33 could not be searched.

- **2026-07-27** `56f0a4eb032a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hostinger/apis/hostinger-api/changes/api/mail/v1/orders/:orderId/aliases/get.md)

---

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