https://exclusivo.one/api/v1 · scopes orders:read, orders:write
List orders
Response
Store API
Orders
List and read orders.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
List and read orders.
https://exclusivo.one/api/v1 · scopes orders:read, orders:write
GET /api/v1/orders
| Parameter | Type | Default | |
|---|---|---|---|
limit | integer | 50 | Max 100 |
cursor | string | — | An order id from pagination.nextCursor |
status | string | — | Filter by status |
customer_id | string | — | Filter by customer |
start_date | date | — | On or after |
end_date | date | — | On or before |
curl "https://exclusivo.one/api/v1/orders?status=paid&limit=50" \
-H "Authorization: Bearer ex_live_your_key_here"
const res = await fetch(
'https://exclusivo.one/api/v1/orders?status=paid&limit=50',
{ headers: { Authorization: `Bearer ${process.env.EXC_API_KEY}` } }
);
const { data, pagination } = await res.json();
{
"data": [
{
"id": "ord_abc123",
"status": "paid",
"userId": "cus_xyz789",
"total": "56.00",
"currency": "AUD",
"items": [
{ "productId": "prod_abc123", "name": "Ceramic Mug", "quantity": 2, "price": "28.00" }
],
"shipping": { "…": "address and chosen option" },
"fulfillment": { "…": "tracking, once a label is bought" },
"createdAt": "2026-08-19T22:04:11.000Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "ord_abc123",
"count": 50
}
}
count: 2 while
hasMore is still true. A short or empty page doesn’t mean there’s nothing left.Page until hasMore is false.async function allOrders(filters = {}) {
const out = [];
let cursor = null;
do {
const qs = new URLSearchParams({ ...filters, limit: '100', ...(cursor ? { cursor } : {}) });
const res = await fetch(`https://exclusivo.one/api/v1/orders?${qs}`, {
headers: { Authorization: `Bearer ${process.env.EXC_API_KEY}` },
});
const { data, pagination } = await res.json();
out.push(...data);
cursor = pagination.hasMore ? pagination.nextCursor : null;
} while (cursor);
return out;
}
order.created, order.paid, order.fulfilled, order.refunded — and keep
this endpoint for backfills.GET /api/v1/orders/{orderId}
| Status | |
|---|---|
401 | Missing or invalid key |
403 | Key lacks orders:read |
404 | Not in your shop |
429 | Rate limited |