Skip to main content
GET
/
billing
/
plans
List Plans
curl --request GET \
  --url https://api.example.com/billing/plans
{
  "slug": "<string>",
  "price_cents": 123,
  "monthly_credits": 123,
  "allowed_models": [
    "<string>"
  ],
  "allowed_features": [
    "<string>"
  ]
}
Returns every active plan a team can subscribe to. Use it to render pricing pages or to let an agent reason about the upgrade path when credits run low.

​
Response

200
[
  {
    "id": "plan-uuid",
    "slug": "starter",
    "name": "Starter",
    "description": "For hobbyists",
    "is_active": true,
    "price_cents": 1200,
    "currency": "usd",
    "monthly_credits": 200,
    "allowed_models": ["fal:nano-banana-2"],
    "allowed_features": ["influencer"],
    "stripe_product_id": "prod_...",
    "stripe_price_id": "price_...",
    "sort_order": 10
  }
]

​
Fields

​
slug
string
URL-safe identifier. Stable across renames of name.
​
price_cents
integer
Monthly price in the smallest currency unit (cents for USD).
​
monthly_credits
integer
Credits granted at each billing cycle. Resets credits_remaining on /billing/subscription.
​
allowed_models
string[]
Model ids this plan can call. A generation request against a model not in this list returns 403.
​
allowed_features
string[]
Feature surfaces (e.g. influencer, slides, broll, export) the plan includes. Separate from models.

​
Example

cURL
curl https://api.supapost.so/billing/plans \
  -H "Authorization: Bearer YOUR_API_KEY"