Get Plans

Get all plans with filtering, sorting, and pagination.

When a client_id filter is present, Stripe subscriptions that exist in Stripe but have not yet been synced to the database are appended to the response with source="stripe" so admins can see the full picture.

get/api/v1/admin/plans

Request

Base URL: https://carbonarc.ai (the document declares no server; this is the origin it was published from)
URL: https://carbonarc.ai/api/v1/admin/plans
Auth: OAuth 2 (authorization code, authorization URL authorize, token URL token)

Query parameters

filterstring nullable

sortstring nullable

rangestring nullable

Response

Successful Response

namestring required

product_idstring uuid nullable

client_idstring uuid required

amountnumber required

billing_cyclestring

statusstring nullable

starts_atstring date-time nullable

ends_atstring date-time nullable

configobject nullable

canceled_atstring date-time nullable

trial_endstring date-time nullable

stripe_subscription_idstring nullable

stripe_customer_idstring nullable

Stripe customer id (cus_...) for this plan/client

created_atstring date-time required

updated_atstring date-time required

created_bystring nullable

updated_bystring nullable

billing_emailstring email nullable

daily_token_limitnumber nullable

Configured daily token limit from plan

grace_period_started_atstring date-time nullable

failed_payment_retry_countinteger

is_suspendedboolean

suspended_atstring date-time nullable

sourcestring nullable

Where the plan record came from: 'database' or 'stripe'

stripe_cancel_atstring date-time nullable

Scheduled cancellation date from linked Stripe subscription

stripe_canceled_atstring date-time nullable

Actual cancellation date from linked Stripe subscription

Changes

No recorded changes to this operation across all 4 revisions of this API.