---
title: "List orders"
method: GET
path: "/v1/orders"
tags: ["public", "orders"]
---

# List orders

`GET /v1/orders`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/orders`
- Auth: API key in header `Authorization`

Returns every order on the account, newest first. Paginate with `limit` and the `next_cursor` from the previous page. Rows carry no instance linkage or installed-app card — read a single order for those.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- OrderingPublicOrderList
  - `next_cursor` string
  - `orders` OrderingPublicOrderSummary[]
    - `billing_mode` string
    - `checkout_id` string
    - `created_at` string
    - `deny_reason` string
    - `id` string
    - `kind` string: Kind and PricingShape cost nothing here: they are already on the row the list selects, and both genuinely vary — a second product kind or a one_time shape changes them with no code change here. Operation is deliberately ABSENT, unlike on publicOrder. This list is PURCHASE-ONLY by construction: ListOrdersByAccountPage is `WHERE account_id = $1 AND operation = 'purchase'` (queries/ordering.sql, BAN-1604), so the field could only ever be "purchase" here — while GET /v1/orders/{id} really does return "change" for a resize. Publishing it would make one row describe itself differently on two routes, and a structurally constant field is the promise-not-kept this contract refuses. CheckoutID, by contrast, is genuinely variable and already on the row this list selects (BAN-1605), so it costs nothing — and the list row is where a client groups one submission's orders. items[] is absent too: it would turn one page into N extra queries on a route built to be polled.
    - `pricing_shape` string
    - `status` 'pending_payment' | 'held' | 'blocked' | 'fulfilled' | 'failed' | 'paid_but_quota_blocked' | 'paid_but_release_fenced' | 'reconciling' | 'cancelled' | 'expired'

## Other responses

- `400`: bad_cursor or bad_limit
- `401`: invalid or missing API key
- `403`: the key lacks orders:read

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)