ResourcesOrders
List orders
List canonical orders for the authenticated store with composable filters and bounded pagination.
Authorization
bearerAuth storeAuth AuthorizationBearer <token>
Provide your SellApp API key as a bearer token.
In: header
X-STORE<token>
Select the SellApp store for this API request.
In: header
Query Parameters
limit?integer
Number of items to return per page.
Default
15Range
1 <= value <= 100page?integer
Page number to return.
Default
1Range
1 <= valueResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://sell.app/api/v2/orders"{
"data": [
{
"id": 1042,
"status": "COMPLETED",
"timeline": [
{
"status": "COMPLETED",
"set_at": "2026-07-12T12:05:00.000Z"
},
{
"status": "PENDING",
"set_at": "2026-07-12T12:00:00.000Z"
}
],
"customer": {
"id": 88,
"email": "buyer@example.com",
"country": "United States",
"location": "New York",
"proxied": false
},
"payment": {
"method": "STRIPE",
"transaction_id": "pi_3Example",
"payment_id": "pi_3Example",
"payment_capture_id": null,
"blockchain_txid": null,
"settlement_gateway": null,
"has_checkout_url": true
},
"totals": {
"currency": "USD",
"subtotal_cents": 1000,
"total_exclusive_cents": 1000,
"total_cents": 1000,
"total_exclusive_usd_cents": 1000,
"total_usd_cents": 1000
},
"coupon_id": null,
"line_items": [
{
"id": 2201,
"product_id": 77,
"product_variant_id": 91,
"product_title": "Writing community access",
"variant_title": "Monthly",
"quantity": 1,
"status": "COMPLETED",
"currency": "USD",
"subtotal_cents": 1000,
"total_exclusive_cents": 1000,
"total_cents": 1000,
"subscription_id": 312,
"created_at": "2026-07-12T12:00:00.000Z"
}
],
"created_at": "2026-07-12T12:00:00.000Z",
"updated_at": "2026-07-12T12:05:00.000Z"
}
],
"links": {},
"meta": {}
}{
"message": "Unauthenticated."
}{
"message": "This action is unauthorized."
}{
"message": "The given data was invalid.",
"errors": {
"data": [
"The data field is required."
]
}
}