Get customer | ListBee

Get a single customer by ID. Customers are auto-created from order data — they represent unique buyer email addresses that have purchased from the seller.

Authentication

AuthorizationBearer

API key (lb_ prefix). Pass as: Authorization: Bearer lb_...

Path parameters

customer_idstringRequired

Customer ID.

Response

Successful Response

idstring

Unique identifier.

emailstring

Buyer email address.

total_ordersinteger

Total number of completed orders from this buyer.

total_spentinteger

Total amount spent in cents (smallest currency unit).

currencystring

Currency code.

created_atdatetime

When this customer record was created.

object"customer"

Object type identifier. Always customer.

first_order_atdatetime or null

When this buyer first purchased.

last_order_atdatetime or null

When this buyer most recently purchased.

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

1	import requests
2
3	url = "https://api.listbee.so/v1/customers/customer_id"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"id": "cus_7kQ2xY9mN3pR5tW1vB8a01",
3	"email": "alice@example.com",
4	"total_orders": 3,
5	"total_spent": 8700,
6	"currency": "usd",
7	"created_at": "2026-03-15T10:00:00Z",
8	"object": "customer",
9	"first_order_at": "2026-03-15T10:00:00Z",
10	"last_order_at": "2026-04-01T14:30:00Z"
11	}