Orders
Validate a draft order
Validates a draft order: computes its prices and, with a live key, debits the account and sends it to production. The order must be in draft status. Test orders debit nothing.
Request
Authorization
Bearer token
Send your API key in the Authorization header: Authorization: Bearer sk_test_…. A sk_test_ key creates and sees test orders only. Keys and test mode.
Path parameters
accountIdstringrequiredUnique identifier of the accountorderIdstringrequiredUnique identifier of the order
Responses
200Order validated successfully
successbooleanpricesobjectprices.itemsarray of objectprices.items[].indexintegerprices.items[].quantityintegerprices.items[].productIdstringprices.items[].unit_chargesobjectprices.items[].chargesobjectprices.items[].pricenumberprices.items[].unit_pricenumberprices.shippingobjectprices.shipping.transporterstringprices.shipping.pricenumberprices.totalnumber
400Bad request, invalid input
Type: Error
401Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (INVALID_TOKEN)
Type: Error
403The API key is inactive or revoked (INACTIVE_API_KEY), or targets another account (ACCOUNT_ACCESS_DENIED, refused once the account guard is enforced); with an OAuth access token: a token of scope mcp (INSUFFICIENT_SCOPE), a path naming another account or a person no longer a member of it (ACCOUNT_ACCESS_DENIED), a real token on the sandbox host (SANDBOX_REQUIRES_TEST_KEY)
Type: Error
404Order not found
Type: Error
429
500Internal server error
Type: Error