SellApp
ApiResourcesCustomers

Retrieve a customer

Retrieve a customer profile and concise relationship insights.

GET
/v2/customers/{customer}

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

customer*integer

The customer path parameter.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://sell.app/api/v2/customers/0"
{
  "data": {
    "id": 125,
    "email": "buyer@example.com",
    "insights": {
      "orders_count": 3,
      "line_items_count": 4,
      "completed_line_items_count": 3,
      "pending_line_items_count": 1,
      "voided_line_items_count": 0,
      "subscriptions_count": 1,
      "revenue_usd_cents": 10900,
      "first_purchase_at": "2026-06-10T13:15:00.000000Z",
      "last_purchase_at": "2026-07-10T13:15:00.000000Z",
      "favorite_payment_method": "STRIPE"
    },
    "wallet": {
      "status": "active",
      "balance_cents": 2500
    },
    "created_at": "2026-06-10T13:15:00.000000Z",
    "updated_at": "2026-07-10T13:15:00.000000Z"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "Rule not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}