List orders | ListBee

List orders for the authenticated account. Filter by status, listing, and date range. Paginated. Order lifecycle: PENDING (checkout started, buyer data captured) → PAID (payment confirmed, order.paid webhook fires) → PROCESSING (only for generated listings: agent is generating content) → FULFILLED (content delivered or order closed). Static listings auto-fulfill on payment. Generated listings enter PROCESSING until POST /fulfill is called. Webhook listings stay PAID — the seller’s system handles delivery externally. Terminal error states: CANCELED (payment failed or abandoned), FAILED (system error). Use content_type on each order to branch your handling logic.

List orders for the authenticated account. Filter by status, listing, and date range. Paginated. Order lifecycle: PENDING (checkout started, buyer data captured) → PAID (payment confirmed, order.paid webhook fires) → PROCESSING (only for generated listings: agent is generating content) → FULFILLED (content delivered or order closed). Static listings auto-fulfill on payment. Generated listings enter PROCESSING until POST /fulfill is called. Webhook listings stay PAID — the seller's system handles delivery externally. Terminal error states: CANCELED (payment failed or abandoned), FAILED (system error). Use content_type on each order to branch your handling logic.

Authentication

AuthorizationBearer

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

Query parameters

statusenum or nullOptional

Filter orders by status.

listingstring or nullOptional

Filter by listing ID (lst_ prefixed).

buyer_emailstring or nullOptional

Filter by exact buyer email address.

created_afterdatetime or nullOptional

Only orders created after this ISO 8601 datetime.

created_beforedatetime or nullOptional

Only orders created before this ISO 8601 datetime.

cursorstring or nullOptional

Pagination cursor from a previous response.

limitintegerOptional1-100Defaults to 20

Maximum number of orders to return.

Response

Successful Response

datalist of objects

Array of order objects.

object"list"

Object type identifier. Always list.

total_countintegerDefaults to 0

Total number of matching resources across all pages

cursorstring or null

Pass as cursor query param to fetch the next page

has_morebooleanDefaults to false

True if more results exist beyond this page

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

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