List customers | ListBee

List customers (buyers) for the authenticated account. Customers are auto-created when a buyer completes their first order. Use this endpoint to get buyer email addresses for marketing, analyze purchasing patterns, or identify repeat customers. Sorted by most recent purchase first.

Authentication

AuthorizationBearer

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

Query parameters

emailstring or nullOptional

Filter by exact buyer email address.

created_afterdatetime or nullOptional

Only customers created after this ISO 8601 datetime.

created_beforedatetime or nullOptional

Only customers created before this ISO 8601 datetime.

cursorstring or nullOptional

Pagination cursor from a previous response.

limitintegerOptional1-100Defaults to 20

Maximum number of customers to return.

Response

Successful Response

datalist of objects

Array of customer objects.

has_moreboolean

Whether more results exist.

object"list"

Object type identifier.

cursorstring or null

Cursor for next page.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

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