Skip to main content
POST
/
credits
/
buy
Buy Credits
curl --request POST \
  --url https://api.example.com/credits/buy
Purchases top-up credits for your organization. Depending on billing state, Mosaic either charges immediately or returns a hosted checkout URL.

​
Request

curl -X POST "https://api.mosaic.so/credits/buy" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "credits": 1000
  }'

​
Body Parameters

FieldTypeRequiredDescription
creditsnumberYesNumber of credits to buy (100 to 1,000,000).
success_urlstringNoOverride checkout success redirect URL.
cancel_urlstringNoOverride checkout cancel redirect URL.

​
Response (Immediate Purchase)

{
  "success": true,
  "requires_checkout": false,
  "credits_purchased": 1000,
  "amount_charged_usd": 20,
  "plan": "creator"
}

​
Response (Checkout Required)

{
  "success": false,
  "requires_checkout": true,
  "checkout_url": "https://billing.autumn.com/checkout/...",
  "credits_requested": 1000,
  "estimated_cost_usd": 20
}