ResourcesOrders
Search orders
Search canonical orders using transaction, customer, product, delivery, payment, and status filters.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://sell.app/api/v2/orders/search" \ -H "Content-Type: application/json" \ -d '{ "filters": [ { "field": "transaction_id", "operator": "contains", "value": "pi_3Example" }, { "field": "status", "operator": "in", "value": [ "COMPLETED" ] } ], "sort": [ { "field": "created_at", "direction": "desc" } ], "pagination": { "page": 1, "limit": 25 } }'{
"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."
]
}
}