Use when selling digital products, creating listings, processing orders, or integrating payments via the ListBee commerce API.
Commerce API for AI agents. Create a store, list products, collect payments, deliver digital content.
Base URL: https://api.listbee.so
Auth: Authorization: Bearer lb_...
Docs: https://docs.listbee.so
references/bootstrap.mdreferences/listing-builder.mdreferences/fulfillment.md (managed mode)references/fulfillment.md (agent-fulfilled mode)references/checkout-schema.mdreferences/readiness.mdreferences/webhooks.mdreferences/files-and-deliverables.mdreferences/errors.md + references/idempotency.md1900 = $19.00. Values 1–99 are rejected.content_type field. Fulfillment mode is implicit from deliverables.Idempotency-Key on POST requests. 24h window.readiness.next is the highest-priority action. Start there.kind: api = agent executes. kind: human = present URL to user. Never automate human actions.kind: human.{data, has_more, cursor}.| Method | Path | Description |
|---|---|---|
| GET | /v1/ping | Health check |
| POST | /v1/bootstrap | Send OTP to email — start account creation |
| POST | /v1/bootstrap/verify | Verify OTP — creates account, returns session |
| POST | /v1/bootstrap/store | Create store from session — returns API key |
| GET | /v1/account | Get account (email, Stripe status) |
| PUT | /v1/account | Update account |
| DELETE | /v1/account | Delete account |
| POST | /v1/account/stripe/connect | Start Stripe Connect onboarding → returns URL |
| DELETE | /v1/account/stripe | Disconnect Stripe |
| GET | /v1/store | Get store + readiness |
| PUT | /v1/store | Update store (display_name, bio, avatar, slug, ga_measurement_id) |
| POST | /v1/files | Upload file → returns token for deliverables/cover |
| POST | /v1/listings | Create listing |
| GET | /v1/listings | List listings (cursor paginated) |
| GET | /v1/listings/{listing_id} | Get listing + readiness |
| PUT | /v1/listings/{listing_id} | Update listing |
| DELETE | /v1/listings/{listing_id} | Delete listing |
| PUT | /v1/listings/{listing_id}/deliverables | Replace all deliverables |
| POST | /v1/listings/{listing_id}/deliverables | Add deliverable |
| DELETE | /v1/listings/{listing_id}/deliverables | Remove all deliverables |
| DELETE | /v1/listings/{listing_id}/deliverables/{deliverable_id} | Remove one deliverable |
| POST | /v1/listings/{listing_id}/publish | Publish listing |
| GET | /v1/orders | List orders (cursor paginated) |
| GET | /v1/orders/{order_id} | Get order |
| POST | /v1/orders/{order_id}/fulfill | Push content → fulfills order |
| POST | /v1/orders/{order_id}/refund | Refund order |
| GET | /v1/customers | List customers |
| GET | /v1/customers/{customer_id} | Get customer |
| GET | /v1/webhooks | List webhooks |
| POST | /v1/webhooks | Create webhook |
| PUT | /v1/webhooks/{webhook_id} | Update webhook |
| DELETE | /v1/webhooks/{webhook_id} | Delete webhook |
| GET | /v1/webhooks/{webhook_id}/events | List webhook delivery events |
| POST | /v1/webhooks/{webhook_id}/events/{event_id}/retry | Retry webhook delivery |
| POST | /v1/webhooks/{webhook_id}/test | Send test event |
| GET | /v1/plans | List available plans |
| Event | Fires when |
|---|---|
order.paid | Payment confirmed |
order.fulfilled | Content delivered to buyer |
order.refunded | Refund issued |
order.disputed | Chargeback opened |
order.dispute_closed | Dispute resolved |
order.canceled | Checkout abandoned (24h TTL) |
listing.created | New listing created |
listing.updated | Listing updated |
listing.published | Listing goes live |
listing.out_of_stock | Stock hits 0 |
listing.deleted | Listing deleted |
customer.created | New buyer record |
| Prefix | Entity |
|---|---|
lst_ | Listing |
ord_ | Order |
acc_ | Account |
st_ | Store |
wh_ | Webhook |
evt_ | Webhook event |
ag_ | Access grant |
lb_ | API key value (used in Bearer token) |