List events | ListBee

List events delivered to this account. Useful for reconciling missed webhook deliveries or auditing order history. Cursor-paginated, newest first. Events are persisted for every order.paid, order.fulfilled, order.refunded, and order.disputed delivery — the payload matches what was sent to agent_callback_url.

Authentication

AuthorizationBearer

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

Query parameters

typestring or nullOptional

Filter to a single event type (e.g. order.paid).

listing_idstring or nullOptional

Filter to events tied to a specific listing.

order_idstring or nullOptional

Filter to events tied to a specific order.

cursorstring or nullOptional

Opaque pagination cursor from a previous response.

limitintegerOptional1-100Defaults to 50

Page size, default 50.

Response

Successful Response

datalist of objects

Array of event objects, newest first.

object"list"

Object type identifier. Always list.

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/events"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"data": [
3	{
4	"id": "evt_abc123xyz",
5	"type": "order.paid",
6	"account_id": "acc_7kQ2xY9mN3pR5tW1vB8a",
7	"created_at": "2026-04-02T14:30:00Z",
8	"data": {
9	"object": "event",
10	"type": "order.paid"
11	},
12	"object": "event",
13	"listing_id": "lst_7kQ2xY9mN3pR5tW1vB8a",
14	"order_id": "ord_9xM4kP7nR2qT5wY1"
15	}
16	],
17	"object": "list",
18	"cursor": "evt_abc123xyz",
19	"has_more": false
20	}