Customers API
Access customer data aggregated from orders
Customers API
Retrieve customer information aggregated from order data.
List Customers
GET /v1/customersReturns unique customers based on email addresses from orders.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
limit | integer | Items per page (default: 25, max: 100) |
email | string | Search by email (partial match) |
Response
{
"data": [
{
"email": "customer@example.com",
"order_count": 5,
"completed_orders": 4,
"total_spent": 149.95,
"first_order": "2025-01-10T10:00:00Z",
"last_order": "2025-01-25T14:30:00Z",
"country": "United States",
"country_code": "US"
}
],
"meta": {
"total": 234,
"limit": 25,
"offset": 0
}
}Example Request
curl -X GET "https://api.sellgate.cc/v1/customers" \
-H "Authorization: Bearer sg_live_your_api_key"Search by Email
curl -X GET "https://api.sellgate.cc/v1/customers?email=john" \
-H "Authorization: Bearer sg_live_your_api_key"Customer Object
| Field | Type | Description |
|---|---|---|
email | string | Customer email address |
order_count | integer | Total number of orders |
completed_orders | integer | Number of completed orders |
total_spent | number | Total amount spent (completed orders only) |
first_order | string | First order timestamp |
last_order | string | Most recent order timestamp |
country | string | Country name (from most recent order) |
country_code | string | Country code (from most recent order) |
Customer data is aggregated from orders. The API does not maintain a separate customer database.