01
Account usage#
GET /v0/me returns your plan (free, builder, team, or enterprise), used/limit pairs for inboxes, domains, pods, and webhooks, sends today and this month with their limits and overage price, unread messages, and the API rate limit. Pod and inbox keys receive only counts within their scope (no domain, pod, or webhook counts).
curl https://botinbox.dev/v0/me -H "Authorization: Bearer $BOTINBOX_API_KEY"02
Limits#
Each plan sets caps for inboxes, custom domains, pods, webhooks, and daily and monthly sends; see the pricing page for current values. Free stops sending at its monthly limit, while Builder and Team keep sending and bill extra sends per 1,000. Over a daily or resource limit the API returns 429 with a code such as plan_limit or quota_exceeded. Receiving mail never counts against your sends.
03
Changing plans#
Upgrade, downgrade, or manage billing from the dashboard. Upgrades apply immediately. Downgrades never delete data: resources above the new limit stay readable but can't grow until you're back under it.