---
title: "List stamp orders"
method: GET
path: "/stamp-orders"
tags: ["Stamp orders"]
---

# List stamp orders

`GET /stamp-orders`

## Request

- Base URL: `https://esahayak.io/api/v1`
- URL: `https://esahayak.io/api/v1/stamp-orders`
- Auth: HTTP bearer

## Response `200`

Paged orders (display status derived).

- OrderList
  - `data` Order[], required
    - `id` string, uuid
    - `reference` string, nullable: Your PO / reference
    - `state` string, nullable: The order's single state (display name) — one order = one state. null on orders created before this contract.
    - `status` 'PLACED' | 'PARTIAL' | 'FULFILLED' | 'CANCELLED': Derived display status (never the raw DB status).
    - `isTest` boolean
    - `counts` object: Per-stage tallies across the order's stamps.
      - `requested` integer
      - `allocated` integer
      - `generated` integer
      - `verified` integer
      - `delivered` integer
      - `cancelled` integer
    - `createdAt` string, date-time
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required: Unfiltered count for the same query.
  - `hasMore` boolean, required: True when more rows exist beyond this page.

## Other responses

- `401`: Missing / invalid / expired / revoked key

---

[API](https://skmtc.dev/esahayak/apis/esahayak-stamp-api.md) - [All operations](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/revisions/cca124862a3e?raw)