Orders
Get the job of a firm order
Polls the job that createOrder with Prefer: respond-async pointed at (its Location). status is pending or running while the order is processed (poll again after Retry-After seconds), then succeeded with result (the order to read with getOrder) or failed with error. A job is only readable by the account that created its order, and in its key's mode (test or live).
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 account, or the alias@mefor the account authenticated by the token.jobIdstring (uuid)requiredThejob.idof the 202 answer
Responses
200The job
successbooleanjobJob
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); 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
404No job of this id for the authenticated account and mode (JOB_NOT_FOUND)
Type: Error
500Internal server error
Type: Error