ResourcesOrders

Retrieve an order

Retrieve one canonical order and its same-store product-level line-item summaries.

Foreign-store order identifiers return 404 rather than exposing whether the order exists.

GET
/v2/orders/{order}

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

Path Parameters

order*integer

The order path parameter.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://sell.app/api/v2/orders/0"
{
  "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"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "Rule not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}