Skip to main content
POST
/
v1
/
billing
/
subscribe
Subscribe
curl --request POST \
  --url https://api.example.com/v1/billing/subscribe
Creates a checkout URL for a new subscription. First-time subscribers get a 7-day trial with 20 credits.

​
Request Body

ParameterTypeRequiredDescription
planstringYesstarter or pro

​
Response 200

{
  "checkout_url": "https://checkout.example.com/c/pay/...",
  "session_id": "cs_live_...",
  "expires_at": "2026-05-02T11:30:00Z",
  "hint": "Open the checkout URL to complete payment.",
  "next_steps": [{ "command": "naive billing status", "description": "Check if payment completed" }]
}
After the user completes payment, the subscription and credits are provisioned automatically via webhook.