/api/v1/orders tenant key Lists your orders, newest first. Status vocabulary: PENDING_PAYMENT (quoted, not yet committed), PENDING (committed, queued for pick-pack), COMPLETED, CANCELLED. The status filter is matched exactly and validated — an unrecognized value returns 400 listing the accepted ones, rather than an empty list you’d have to interpret.
GET /api/v1/orders?limit=10 These inputs are shared across all docs pages, so an id entered here carries over.
Not run yet. Press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).
curl -X GET 'https://service.rip.fun/api/v1/orders?limit=10' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
status | query string | — | Exact-match filter: PENDING_PAYMENT | PENDING | COMPLETED | CANCELLED |
limit / offset | query int | — | limit 1..100 default 50; offset 0..10_000 default 0. has_more signals another page |
data)| Field | Description |
|---|---|
orders[].order_id / status / unique_ids | Order id, lifecycle status, the cards on it |
orders[].shipping_total_cents / sales_tax_cents / currency | Pass-through shipping billed (the quoted amount) + tax |
orders[].carrier / carrier_service / shippo_* | Committed carrier/service, rate + address + shipment ids, tracking + label urls |
orders[].ship_by_at / label_purchased_at / created_at / updated_at | Lifecycle timestamps |
pagination.limit / offset / has_more | Echoed paging + whether more rows exist |
| Status | Code | When |
|---|---|---|
| 400 | invalid status | status is not one of the accepted values |
| 403 | Tenant API key required | key is not tenant-scoped (e.g. a mystery-partner key) |
See Errors for the response envelope and the full code list.