Docs/Billing/Subscribe to a plan

Subscribe to a plan

POST/v1/billing/subscribe🔑 API key required

Create (or switch) a subscription to a paid plan. Returns the on-chain authorization the client signs to activate it.

Body

FieldTypeDescription
planrequiredbuilder | scale | enterpriseThe plan to subscribe to.

Response fields

FieldTypeDescription
subscription.statusstringincomplete until the authorization is signed.
subscription.amountUsdcnumberUSDC pulled each cycle.
authorizationobject{ kind:'usdc-delegate', amountUsdc, interval, status } — what the wallet signs once.
Enterprise is custom-priced (returns 402 custom_pricing — contact sales). Switching plans cancels the previous subscription.