Skip to content

Billing

Billing is managed via Stripe. The billing API endpoints handle subscription status, plan upgrades, and portal access.

Endpoints

Method Path Description
GET /api/v1/account/billing Get billing status and plan
POST /api/v1/account/billing/portal Create Stripe portal session
POST /api/v1/account/billing/upgrade Initiate plan upgrade

Subscription Tiers

Tier Price Key Features
Free $0/mo 50 CVE searches/day, 10 req/min
Standard Contact 500 searches/day, webhooks, 1 environment
Professional Contact Unlimited searches, API keys, SAGE full, 5 environments
API Contact 1000 req/min, unlimited, programmatic access
Enterprise Contact Custom limits, SLA, dedicated support

Upgrade

curl -X POST \
  -H "Authorization: Bearer bs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"plan": "professional"}' \
  "https://breachspider.com/api/v1/account/billing/upgrade"

Returns a Stripe Checkout session URL. Redirect the user to complete payment.

Webhook Events

Stripe sends billing events to /api/v1/billing/stripe-webhook. These are handled internally and update the member's tier automatically.