Get Order

GET 
/order/:order_id

Retrieve details for a specific order by its UUID. Use this to track order progress after creating a purchase.

Order statuses (always upper-case):

• PENDING — order placed and paid; the Energy or Bandwidth delegation is in progress
• COMPLETED — the Energy or Bandwidth is delegated (delegation_txids usually lists the on-chain delegation transaction IDs)
• FAILED — the order could not be fulfilled and was refunded automatically (see error_message)

Orders placed through the API go PENDING → COMPLETED or FAILED. Orders paid directly from a wallet may also show AWAITING_PAYMENT or PROCESSING.

Request

Responses

200

Successful Response

401

The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.

403

The account is blocked (plain-string detail: Account is blocked), or ip_not_allowed — the request's source IP is outside this key's IP allowlist.

404

Order not found — no such order, or it is not yours. detail is a plain string.

422

order_id is not a valid UUID — detail is an array of field errors.

429

Rate limit exceeded — more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.

Response Headers

Retry-After

Seconds until the rate-limit window resets.