Skip to main content
GET
Get subscription

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Response

Subscription details

billing_mode
enum<string>
Available options:
stripe,
external
entitlements
object
plan_type
enum<string>

Canonical plan resolved from the configured plan price ID, independent of billed amount

Available options:
free,
pro,
enterprise
id
string<uuid>

Subscription ID

user_id
string<uuid>

User that owns the subscription

project_id
string<uuid> | null

Project this subscription is scoped to, when applicable

server_usage
number

Active dedicated server records for the account

sandbox_usage
number

Active sandbox records for the account

server_usage_details
object[]

Active server add-on usage with linked project and environment labels

line_items
object[]

Subscription line items. Credits are one-time top-ups and are not included here.

status
string

Subscription status

current_period_start
string | null

Current billing period start timestamp

current_period_end
string | null

Current billing period end timestamp

expires_at
string | null

Subscription expiration timestamp

canceled_at
string | null

Subscription cancellation timestamp

created_at
string

Subscription creation timestamp