Orders

Get the job of a firm order

GET/v2/accounts/{accountId}/jobs/{jobId}Try it

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
  • accountIdstringrequired
    Unique identifier of the account, or the alias @me for the account authenticated by the token.
  • jobIdstring (uuid)required
    The job.id of the 202 answer

Responses

200The job
  • successboolean
  • jobJob
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

Request
curl -X GET "https://api.printags.com/v2/accounts/@me/jobs/{jobId}" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
Response 200
{
  "success": true,
  "job": {
    "id": "0b6f1c9e-3c1a-4e57-9f5e-6a2d8f1b7c40",
    "type": "order.treatment",
    "status": "pending",
    "stage": "queued",
    "orderId": "7b1e2a4c-0000-4000-8000-000000000000",
    "location": "/v2/accounts/@me/jobs/0b6f1c9e-3c1a-4e57-9f5e-6a2d8f1b7c40",
    "retryAfter": 300,
    "result": {
      "orderStatus": "validated",
      "location": "/v2/accounts/@me/orders/7b1e2a4c-0000-4000-8000-000000000000"
    },
    "error": {
      "code": "ORDER_PROCESSING_FAILED"
    }
  }
}