---
title: "List mailbox aliases"
method: GET
path: "/2/mail_hostings/{service_mail}/mailboxes/{mailbox}/aliases"
tags: ["Mailboxes > Aliases"]
---

# List mailbox aliases

`GET /2/mail_hostings/{service_mail}/mailboxes/{mailbox}/aliases`

## Request

- Base URL: `https://api.infomaniak.com`
- URL: `https://api.infomaniak.com/2/mail_hostings/{service_mail}/mailboxes/{mailbox}/aliases`
- Auth: HTTP bearer

Returns list of aliases for the mailbox specified

## Path parameters

- `service_mail` integer, required
- `mailbox` string, required

## Query parameters

- `search` string
- `return` 'total'
- `page` integer
- `per_page` integer
- `order_by` union
  - string
  - string[]
- `order` 'asc' | 'desc'
- `order_for` object

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required: Result of the HTTP request
  - `data` 93e74a89Alias[]
    - `address` string, required
    - `status` 'disabled' | 'enabled', required: Status of the alias.<note><strong>disabled</strong>: The alias is disabled.</note><note><strong>enabled</strong>: The alias is activated.</note>
  - `total` integer: Total number of items Added when using query parameter `page`
  - `page` integer: Number of the current page Added when using query parameter `page`
  - `pages` integer: Total number of pages Added when using query parameter `page`
  - `items_per_page` integer: Number of items per page Added when using query parameter `page`

## Changes

- **2026-10-28** `876c540ed2ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/changes/2/mail_hostings/:service_mail/mailboxes/:mailbox/aliases/get.md)

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) - [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) - [OpenAPI document](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/revisions/96ca7c8a0545?raw)