Billing API

GET  /api/v1/billing/plans              # List plans
GET  /api/v1/billing/subscription       # Current subscription
POST /api/v1/billing/checkout           # Create checkout session
POST /api/v1/billing/portal             # Customer portal
GET  /api/v1/billing/invoices           # List invoices
GET  /api/v1/billing/usage              # Usage summary

Operational Guidance

  • Use the usage endpoint to power in-product spend warnings before checkout limits are reached.
  • Checkout and portal flows usually redirect to the billing provider, so treat them as session-creation endpoints, not direct resource mutations.
  • Invoice data is read-only and best used for account dashboards or exports.
← Providers Overview →