v1
latestOpenAPI 3.0.32026-07-2246176.0 KBRead order status
Returns the lifecycle state of a previously placed order. Consumers POST /v4/account/orders/create, then poll this endpoint every 1–2 seconds with the returned order_id until status === "processed". At that point data.subaccount is populated with the same shape /v4/account/subaccounts emits, so the caller can drop it straight into per-product endpoints like /v4/account/{AccountID}/datacenter_shared/proxy-list.
Gated on account:api_ordering:read. The order's email must match the authenticated identity — mismatches return 404 (not 403) so existence isn't leaked.
Path parameters
Order ID returned by POST /v4/account/orders/create.
Response
Order status. subaccount is null while the order is still being processed; once status === 'processed' the field is populated with the new subaccount's AccountID, AccountType, label, and time_added.
Example response
{
"success": true,
"data": {
"order_id": "e905531c-a2cb-42a4-8df1-182040f369ae",
"status": "processed",
"type": "new_datacenter_shared",
"created_at": 1781256420,
"updated_at": 1781256827,
"price": "26.10",
"currency": "USD",
"paid_with_credit": true,
"subaccount": {
"AccountID": "711d0eff-db25-439e-83dd-e8b81c38cb70",
"AccountType": "datacenter_shared",
"label": "Account 8 (Premium)",
"time_added": 1781256827
}
}
}