Get order status
Get the latest state of a procurement order. Once the background
workflow completes, stamps contains the vendor stamp instances and
status_counts is populated.
stamps[].stamp_idis the public stamp instance ID — use it withGET /api/v1/stamps/download-pdfand for explicit stamp reservation in Esign initialization.
Authorization
bearerAuth Bearer token authentication — paste your access token below.
In: header
Query Parameters
Stamp procurement order client ID (stamp_...).
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/stamps/order-status?client_id=string"{ "data": { "user_id": "user_RQJksjuRzdhRjejyOlhEI", "client_id": "stamp_pkHLyIzspuMWBMXizUSc", "created_at": "2026-04-18T16:35:21.123000", "state_code": "AN", "first_party_name": "Alice Test", "second_party_name": "Bob Test", "article_id": "2337", "stamp_duty_amount": "10", "consideration_amount": 1000, "description": null, "first_party_address": null, "quantity": 1, "status_counts": { "pending": 0, "available": 1, "reserved": 0, "used": 0, "rejected": 0 }, "stamps": [ { "stamp_id": "stamp_inst_uNeOUwjMVGNFexnxFSCP", "status": "available" } ] }, "status_code": 200, "message": "Success", "success": true}Create stamp order POST
Create a stamp procurement order and start the background procurement workflow. - This call is **asynchronous** — a successful response does not mean `stamps` is populated yet. Poll `GET /api/v1/stamps/order-status` or `GET /api/v1/stamps/list` until instances become `available`. - Billing charges `estamp_duty` (`stamp_duty_amount × quantity`) plus `estamp_fees` (one per stamp). The request is rejected if the wallet balance is insufficient.
List stamp orders GET
List procurement orders for the authenticated user, paginated. When filtering by `status=pending`, matching orders are returned with an empty `stamps` array (pending stamps are not yet materialized as instances), while `status_counts.pending` reflects the pending count.