Skip to main content

ListPlans retrieves all available subscription plans.

GET 
/api/v1/billing/plans

Returns a list of plans that can be filtered by tier, active status, or currency. Use this endpoint to display available plans on pricing pages or during the subscription signup flow.

Filtering​

  • By tier: Show only plans of a specific tier (e.g., "professional")
  • By active status: Filter out archived/inactive plans
  • By currency: Show plans priced in a specific currency (KES, USD)

Response​

Returns all matching plans sorted by sort_order ascending. Inactive plans are excluded by default unless explicitly requested.

Errors​

  • UNAUTHENTICATED: Missing or invalid authentication token

Request​

Responses​

A successful response.