---
title: "List account orders"
method: GET
path: "/api/orders/list"
tags: ["Orders"]
---

# List account orders

`GET /api/orders/list`

## Request

- Base URL: `https://api.createprints.ai`
- URL: `https://api.createprints.ai/api/orders/list`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.createprints.ai/api/oauth/authorize`, token URL `https://api.createprints.ai/api/oauth/token`, scopes: `orders:read`)

Returns the authenticated account's orders newest first, including a short reference, customer-facing status, total item quantity, charged total, currency, and checkout-session ID. The current endpoint formats order totals in GBP.

## Query parameters

- `limit` integer
- `cursor` string, date-time

## Response `200`

A cursor-paginated order page.

- OrderList
  - `orders` OrderListItem[], required
    - `orderId` string, uuid, required
    - `orderReference` string, required
    - `createdAt` string, date-time, required
    - `status` string, required
    - `itemQuantity` integer, required
    - `totalAmountCents` integer, required
    - `totalAmountFormatted` string, required
    - `currency` 'GBP', required
    - `stripeSessionId` string, nullable, required
  - `cursor` string, date-time, nullable, required

## Other responses

- `401`: The credential is missing, invalid, revoked, or expired.
- `403`: The credential lacks the required scope or cannot perform this operation.
- `500`: Create Prints could not complete the request.

---

[API](https://skmtc.dev/createprints/apis/create-prints-api.md) · [All operations](https://skmtc.dev/createprints/apis/create-prints-api/llms.txt) · [OpenAPI document](https://skmtc.dev/createprints/apis/create-prints-api/revisions/05c57f496d51?raw)