---
title: "List print orders"
method: GET
path: "/v1/orders"
tags: ["prints"]
---

# List print orders

`GET /v1/orders`

## Request

- Base URL: `https://api.noerrands.com/c/prints`
- URL: `https://api.noerrands.com/c/prints/v1/orders`
- Auth: HTTP bearer

List this account's print orders newest first, with a cursor for paging; free, read-only, and not consequential.

## Query parameters

- `limit` integer
- `cursor` string: Opaque cursor from a previous next_cursor.

## Response `200`

Success.

- object
  - `items` object[], required
    - `order_id` string, required
    - `status` 'submitted' | 'in_production' | 'shipped' | 'cancelled', required: submitted -> in_production -> shipped, or cancelled.
    - `shipping_method` 'budget' | 'standard' | 'express', required
    - `items` object[], required
      - `product` '4x6' | '5x7' | '8x10' | 'canvas-12x16' | 'tshirt' | 'mug-11oz', required
      - `copies` integer, required
      - `shirt_size` 'XS' | 'S' | 'M' | 'L' | 'XL' | '2XL' | '3XL'
      - `shirt_color` 'White' | 'Black'
    - `recipient` object, required
      - `name` string
      - `line1` string
      - `line2` string
      - `city` string
      - `state` string
      - `zip` string
      - `email` string
      - `phone` string
      - `country` string
    - `credits_charged_cents` integer, required: Net of any refund: zero once a cancelled order has been refunded.
    - `tracking` object[]
      - `carrier` string
      - `number` string
      - `url` string
    - `created_at` string, date-time, required
    - `shipped_at` string, date-time
  - `next_cursor` string

## Other responses

- `400`: invalid_request
- `401`: unauthorized. Carries WWW-Authenticate: Bearer resource_metadata="..."
- `403`: forbidden_scope: a write tool called with a read-only key.
- `404`: not_found
- `429`: rate_limited
- `502`: provider_error

---

[API](https://skmtc.dev/noerrands/apis/no-errands-prints-api.md) · [All operations](https://skmtc.dev/noerrands/apis/no-errands-prints-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noerrands/apis/no-errands-prints-api/revisions/f3ad0da7ed08?raw)