---
title: "Get order status and provisioning state for all domains in an order"
method: GET
path: "/v1/domain/orders/{orderId}"
tags: ["domain"]
---

# Get order status and provisioning state for all domains in an order

`GET /v1/domain/orders/{orderId}`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/domain/orders/{orderId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/domain/orders/:orderId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the domains and mailboxes in a purchase order, with per-domain provisioning status.

This endpoint composes two internal calls: <code>GET /domain/purchase-details/{orderId}</code> (domain names, mailbox emails) cross-referenced with <code>GET /domain</code> (per-domain status and expiry).

<strong>Poll this endpoint until all <code>domains[].status</code> values are no longer <code>"inProgress"</code> to confirm provisioning complete.</strong>

Status values: <code>inProgress</code> (provisioning), <code>active</code> (live), <code>deleted</code> (removed), <code>failed</code> (provisioning failed), <code>expired</code> (subscription expired).

Use <code>orderId</code> from <code>GET /v1/domain/orders</code> or from the <code>POST /v1/domain</code> response.

## Path parameters

- `orderId` string, required

## Response `200`

Order status fetched successfully

## Other responses

- `400`: 4000: Failed to fetch order status<br><br>1001: Invalid order id<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)