Billing API
6 endpoints in this group.
POST /api/billing/checkout
Create Checkout
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/billing/limits
Get Limits
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenant_id | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/billing/plans
Get Plans
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
public | query | boolean | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/billing/portal
Create Portal
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/billing/subscription
Get Subscription
Return the tenant's current subscription envelope the web app expects.
Canonical source is active tenant_subscriptions joined to plans, with
legacy users.plan_code and free fallbacks handled by the effective access
resolver.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenant_id | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/billing/webhook
Stripe Webhook
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Stripe-Signature | header | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |