Get account | ListBee

Account status and readiness. Check readiness.operational — if false, readiness.actions lists what’s needed. readiness.next is the highest-priority action.

Authentication

AuthorizationBearer

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

Response

Successful Response

idstring

Unique account ID (acc_ prefixed).

emailstring

Account email address

planstring

Current plan tier. Values: free (10% fee), pro (0% fee).

fee_ratestring

Transaction fee rate as decimal string. Determined by plan: free=0.10, pro=0.00. Applied as platform fee on each order.

billing_statusstring

Subscription billing status. active = payments current. past_due = payment failed, service continues during grace period. unpaid = grace period expired, listings may be blocked.

notify_ordersboolean

Whether seller receives email alerts for new external orders

readinessobject

Account operational readiness. operational is true when the account can sell. If false, actions lists what’s needed with kind (api/human), resolve details, and next points to the highest-priority action.

created_atdatetime

Time at which the account was created

object"account"

Object type identifier. Always account.

currencystring or null

Account currency (ISO 4217, lowercase). Set automatically from Stripe Connect. Cannot be changed after connection.

events_callback_urlstring or null

Optional account-level webhook URL for future non-order events

Errors

401

Unauthorized Error

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

1	{
2	"id": "acc_7kQ2xY9mN3pR5tW1",
3	"email": "seller@example.com",
4	"plan": "free",
5	"fee_rate": "0.10",
6	"billing_status": "active",
7	"notify_orders": true,
8	"readiness": {
9	"operational": true,
10	"actions": [
11	{
12	"code": "stripe_connect_required",
13	"kind": "api",
14	"priority": "required",
15	"message": "Set Stripe secret key to accept payments",
16	"resolve": {
17	"method": "POST",
18	"endpoint": "/v1/account/stripe-key",
19	"url": "https://console.listbee.so/connect/stripe",
20	"params": {
21	"secret_key": "sk_live_..."
22	}
23	}
24	}
25	],
26	"next": "stripe_connect_required"
27	},
28	"created_at": "2026-03-15T10:00:00Z",
29	"object": "account",
30	"currency": "usd",
31	"events_callback_url": "https://agent.example.com/events"
32	}