Orders

Get an order by ID

GET/v2/accounts/{accountId}/orders/{orderId}Try it

Returns an order with its items, units, shipments, status history and prices. A test key only sees test orders, a live key only real orders.

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
  • orderIdstringrequired
    Unique identifier of the order

Responses

200Successfully retrieved order details
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
500Server error

Type: Error

Request
curl -X GET "https://api.printags.com/v2/accounts/123e4567-e89b-12d3-a456-426614174000/orders/987e6543-e21a-11d4-a789-0242ac120002" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
Response 200
{
  "success": true,
  "order": {
    "id": "987e6543-e21a-11d4-a789-0242ac120002",
    "reference": "Order-JeanDupont-2024",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "created",
    "customer": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "email": "[email protected]",
      "firstname": "Jean",
      "lastname": "Dupont",
      "company": "Dupont Entreprises",
      "accountId": "c10e4fdf-a77d-457c-8fd6-2c0b29214800",
      "createdAt": "2024-07-01T09:26:55.737Z"
    },
    "shipTo": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Jean Dupont",
      "phone": "+33612345678",
      "email": "[email protected]"
    },
    "statusHistory": [
      {
        "id": "987e6543-e21a-11d4-a789-0242ac120002",
        "status": "created",
        "createdAt": "2024-07-01T09:26:55.737Z"
      }
    ],
    "units": [
      {}
    ],
    "items": [
      {}
    ],
    "shipments": [
      {}
    ],
    "total": 50.99,
    "files": [
      {
        "id": "3f1c2b7a-5d4e-4f60-9a8b-1c2d3e4f5a6b",
        "mimeType": "application/pdf",
        "size": 48213,
        "filename": "letter.pdf",
        "createdAt": "2026-11-16T09:26:55.737Z"
      }
    ]
  }
}