---
title: "List the orders of an account"
description: "Returns a page of the account's orders, the most recent first (sorted by creation date, not configurable)."
canonical: "https://docs.printags.com/list-the-orders-of-an-account/"
last_updated: "2026-11-16"
---

# List the orders of an account

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

Returns a page of the account's orders, the most recent first (sorted by creation date, not configurable). `page` and `per_page` paginate (defaults 1 and 20); `status` and `search` filter. Each order is a summary: its items, units, customer and recipient, without the prices and shipments of `getOrder`. The `recipient` (name and email of the delivery address) replaces `shipTo`. A test key (`sk_test_`) only lists test orders, a live key only real orders. For the full detail of one order, call `getOrder`. Cursor pagination: every page carries `pagination.next_cursor` and `pagination.has_more`; pass `cursor` (the `next_cursor` of the page before) to get the orders after it, in the same order, without skipping or repeating one when orders are created meanwhile (`page` is then ignored). `limit` sets the page size of both ways (1 to 100). A cursor this API did not give is refused with 400 `INVALID_CURSOR`.

## 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, or the alias `@me` for the account authenticated by the token. |
| `page` | query | string | no | Page number, starting at 1 (default 1). A value that is not a positive whole number is replaced by 1. Declared as a string so that a malformed value is never refused: the route has always accepted it. |
| `per_page` | query | string | no | Orders per page (default 20). A value that is not a positive whole number is replaced by 20. The API sets no maximum: ask for pages of 50 at most. Declared as a string so that a malformed value is never refused: the route has always accepted it. |
| `status` | query | string | no | Keeps the orders in one of these statuses: one status, or several separated by commas (`draft,in_queue`). Statuses are listed by `GET /orders/statuses`. Do not repeat the parameter. |
| `search` | query | string or array of string | no | Free text, 100 characters kept. Send it once: a repeated parameter is accepted but ignored. Matches, without regard to case, a part of the order's reference, of its customer's name, company or email, of its recipient's name or email, or the exact order id. |
| `cursor` | query | string | no | Opaque cursor: the `pagination.next_cursor` of the page before. Returns the orders after that one; `page` is ignored. Do not build it yourself: a value this API did not give is refused with 400 `INVALID_CURSOR`. |
| `limit` | query | integer | no | Page size, 1 to 100 (default: `per_page`, else 20). Any other value is refused with 400 `INVALID_LIMIT`. |

## Responses

| Status | Description |
| --- | --- |
| 200 | A page of orders |
| 400 | `cursor` is not a `next_cursor` of this API (`INVALID_CURSOR`), or `limit` is not 1 to 100 (`INVALID_LIMIT`) |
| 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`) |
| 429 |  |
| 500 | Server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `orders` | array of [Order](/schemas/order/) + object | no | The orders of the page, most recent first. Empty when the page is past the last one. |
| `pagination` | object | no | Without `cursor`: `total`, `page`, `per_page`, `limit`, `next_cursor` and `has_more`. With `cursor`: `limit`, `next_cursor` and `has_more`. |
| `pagination.total` | integer | no | Number of orders matching the filters, all pages together |
| `pagination.page` | integer | no | The page returned |
| `pagination.per_page` | integer | no | The page size used |
| `pagination.limit` | integer | no | The page size used |
| `pagination.next_cursor` | string, nullable | yes | Pass it as `cursor` to get the next page; null on the last page |
| `pagination.has_more` | boolean | yes | Whether orders follow this page |

```json
{
  "success": true,
  "orders": [
    {
      "id": "987e6543-e21a-11d4-a789-0242ac120002",
      "reference": "Order-JeanDupont-2024",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "status": "created",
      "statusHistory": [],
      "units": [],
      "items": [],
      "shipments": [],
      "total": 50.99,
      "files": [],
      "recipient": {
        "name": "Jean Dupont",
        "email": "jean@example.com"
      }
    }
  ],
  "pagination": {
    "total": 134,
    "page": 1,
    "per_page": 20,
    "limit": 20,
    "next_cursor": "WyIyMDI2LTExLTA5VDEwOjAwOjAwLjAwMFoiLCI3YjFlMmE0Yy0wMDAwLTQwMDAtODAwMC0wMDAwMDAwMDAwMDAiXQ",
    "has_more": true
  }
}
```

## Example

```bash
curl -X GET "https://api.printags.com/v2/accounts/@me/orders" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
```
