---
title: "List orders"
method: GET
path: "/api/mail/v1/orders"
tags: ["Mail: Orders"]
---

# List orders

`GET /api/mail/v1/orders`

Retrieve a paginated list of mail orders associated with your account.

Use this endpoint to monitor your mail services, including their status,
plan, attached domain, and expiration details.

## Query parameters

- `domain` string, nullable
- `status` 'pending_setup' | 'active' | 'suspended', nullable
- `is_trial` boolean, nullable
- `sort` 'created_at' | '-created_at' | 'expires_at' | '-expires_at', nullable
- `page` integer
- `per_page` integer

## Response `200`

Success response

- object
  - `data` MailV1OrdersOrderResource[] — Array of [`Mail.V1.Orders.OrderResource`](#model/mailv1ordersorderresource)
    - `id` string — Order resource ID
    - `status` 'pending_setup' | 'active' | 'suspended' — Order status
    - `is_trial` boolean — Whether the order is currently in a trial period
    - `seats` integer — Number of mailbox seats purchased with the order
    - `domain` MailV1OrdersOrderDomainResource
      - `id` string — Domain resource ID
      - `name` string — Domain name
    - `plan` MailV1OrdersOrderPlanResource
      - `name` string — Plan name
      - `title` string — Plan title
    - `has_pending_upgrade` boolean — Whether an upgrade is currently pending for the order
    - `created_at` string, date-time
    - `expires_at` string, date-time, nullable
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

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

---

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