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

# List orders

`GET /api/hosting/v1/orders`

Retrieve a paginated list of orders accessible to the authenticated client.

This endpoint returns orders of your hosting accounts as well as orders
of other client hosting accounts that have shared access with you.

Use the available query parameters to filter results by order statuses
or specific order IDs for more targeted results.

## Query parameters

- `page` integer
- `per_page` integer
- `statuses` string[], nullable
- `order_ids` integer[], nullable

## Response `200`

Success response

- object
  - `data` HostingV1OrdersOrderResource[] — Array of [`Hosting.V1.Orders.OrderResource`](#model/hostingv1ordersorderresource)
    - `id` integer — Order ID
    - `client_id` integer — Client ID
    - `subscription_id` string, nullable — Subscription ID
    - `created_at` string, date-time — Creation date
    - `plan` HostingV1OrdersPlanResource
      - `name` string — Plan name
    - `status` string — Order status
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated 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)