---
title: "Get current plan"
method: GET
path: "/billing/subscription"
tags: ["billing"]
---

# Get current plan

`GET /billing/subscription`

Returns the caller organization's active subscription plan. Only an active subscription is returned; if the org has none, this responds 404. (The status field is therefore always 'active' here.)

## Response `200`

OK

- SubscriptionResponse — Full subscription record returned by subscription endpoints.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `balance_display` string, required — Formatted balance string (e.g., '$12.50').
  - `balance_microdollars` integer, required — Current account balance in microdollars.
  - `billing_cycle` 'monthly' | 'yearly', required — Billing frequency for this subscription.
  - `cancel_at_period_end` boolean, required — Whether the subscription cancels at the end of the period.
  - `canceled_at` string, date-time — Timestamp when the subscription was canceled.
  - `current_period_end` string, date-time, required — End of the current billing period.
  - `current_period_start` string, date-time, required — Start of the current billing period.
  - `id` string, uuid, required — Subscription identifier.
  - `included_balance_display` string, required — Formatted included balance (e.g., '$10.00').
  - `included_balance_microdollars` integer, required — Balance granted each billing period in microdollars.
  - `max_concurrent_runs` integer, required — Maximum simultaneous runs allowed on this plan.
  - `monthly_price` number, double, required — Monthly plan price in dollars.
  - `pending_downgrade_effective_date` string, date-time — When the pending downgrade takes effect.
  - `pending_downgrade_plan_id` string — Plan ID of a scheduled future downgrade.
  - `plan_id` string, uuid, required — Billing plan's identifier.
  - `plan_name` string, required — Customer-facing plan name (Hobby, Pro, Scale, Enterprise).
  - `price_per_second_microdollars` integer, required — Per-second compute charge in microdollars.
  - `status` 'active' | 'canceled' | 'past_due' | 'trialing' | 'incomplete' | 'incomplete_expired' | 'unpaid', required — Current lifecycle state of the subscription.
  - `trial_end` string, date-time — Timestamp when the free trial ends.
  - `yearly_price` number, double, required — Annual plan price in dollars.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/108ab4b41051/schema)