Skip to main content
GET
/
customers
/
{id}
Get a customer
curl --request GET \
  --url https://api.salesive.com/api/v1/customers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "success": true,
  "message": "Customer retrieved",
  "data": {
    "_id": "665a1f2c9b1e4a0012ab34cd",
    "user": {
      "_id": "6650aa11bb22cc33dd44ee55",
      "name": "Ada Obi",
      "email": "ada@example.com",
      "avatar": "https://cdn.example.com/u/ada.png"
    },
    "shop": "664f0e2a1c2b3d4e5f6a7b8c",
    "name": "Ada Obi",
    "phone": "+2348012345678",
    "email": "ada@example.com",
    "lastActive": "2026-06-27T14:05:00.000Z",
    "online": false,
    "active": true,
    "createdAt": "2026-05-01T09:00:00.000Z",
    "updatedAt": "2026-06-27T14:05:00.000Z",
    "avatar": "https://cdn.example.com/u/ada.png",
    "cart": {
      "_id": "6661aa22bb33cc44dd55ee66",
      "items": [
        {
          "product": "6659ddee0011223344556677",
          "quantity": 2
        }
      ],
      "totalPrice": 15000,
      "createdAt": "2026-06-20T10:00:00.000Z",
      "updatedAt": "2026-06-27T13:00:00.000Z"
    },
    "wishlist": {
      "_id": "6662bb33cc44dd55ee66ff77",
      "items": [
        {
          "product": {
            "_id": "6659ddee0011223344556677",
            "name": "Wireless Earbuds",
            "image": "https://cdn.example.com/p/earbuds.png",
            "price": 7500
          }
        }
      ]
    },
    "recentOrders": [
      {
        "_id": "6663cc44dd55ee66ff7700aa",
        "orderId": "ORD-10421",
        "status": "delivered",
        "subtotal": 15000,
        "shippingCost": 1500,
        "discount": 0,
        "items": [
          {
            "product": "6659ddee0011223344556677",
            "quantity": 2
          }
        ],
        "createdAt": "2026-06-25T11:30:00.000Z"
      }
    ],
    "stats": {
      "totalOrders": 6,
      "totalSpent": 98500,
      "lastOrderDate": "2026-06-25T11:30:00.000Z"
    }
  }
}
Returns one customer with their populated user profile, current cart, wishlist, up to 5 recent orders and aggregate order stats. The id may be the customer record id or the underlying user id. The store is bound to your app token server-side — never send a shop id.

Authorizations

​
Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Path Parameters

​
id
string
required

The customer record id, or the underlying user id of the customer.

Response

The requested customer, enriched with cart, wishlist, recent orders and stats.

Standard Salesive response envelope. The operation-specific payload is carried in data.

​
status
integer
required

HTTP status code, echoed in the body.

​
success
boolean
required

Whether the request succeeded.

​
message
string
required

Human-readable result message.

​
data
object

A customer enriched with cart, wishlist, recent orders and aggregate stats.