Skip to main content
GET
Get current tier

Response

Tier information

Current billing tier information for the authenticated tenant.

tier
string
required

DEPRECATED - use plan_slug. Subscription tier: free, pro, studio, or enterprise

plan_slug
string
required

Canonical billing plan slug (mirrors tier). Replaces tier per project-pack-identity R4.

limits
TierLimitsResponse · object
required

Feature limits for the current tier.

billing_customer_id
string | null

Billing customer ID (null if billing not configured)

current_period_end
string | null

ISO-8601 end date of the current billing period

api_calls_limit
integer | null

Per-period cap on API calls for this tier, or null for unlimited. Sourced from feature_gates.TIER_FEATURES[tier].max_api_calls.

entities
integer | null

Tenant-wide cap on items (entities), or null for unlimited. Sourced from billing.tier_limits.PROJECT_TIER_LIMITS[tier]['entities'].

projects
integer | null

Cap on the number of projects this tenant can own, or null for unlimited. Sourced from billing.tier_limits.PROJECT_TIER_LIMITS[tier]['projects'].