---
title: "Get an order by ID"
description: "Returns an order with its items, units, shipments, status history and prices."
canonical: "https://docs.printags.com/get-an-order-by-id/"
last_updated: "2026-11-16"
---

# Get an order by ID

`GET /v2/accounts/{accountId}/orders/{orderId}`

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.

## Authentication

An API key as a Bearer token: `Authorization: Bearer <key>`. A `sk_test_` key creates and sees test orders only. Keys and test mode: [overview](/).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `accountId` | path | string | yes | Unique identifier of the account |
| `orderId` | path | string | yes | Unique identifier of the order |

## Responses

| Status | Description |
| --- | --- |
| 200 | Successfully retrieved order details |
| 401 | Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (`INVALID_TOKEN`) |
| 403 | The 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`) |
| 404 | Order not found |
| 429 |  |
| 500 | Server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `order` | [Order](/schemas/order/) | no |  |

```json
{
  "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": "jean.dupont@example.fr",
      "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": "jean.dupont@example.fr"
    },
    "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"
      }
    ]
  }
}
```

## Example

```bash
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"
```
