---
title: "The account's live subscription (tier, status, period end, cancel at period end, the tier's supervised rate), or null"
method: GET
path: "/v1/account/billing/subscription"
---

# The account's live subscription (tier, status, period end, cancel at period end, the tier's supervised rate), or null

`GET /v1/account/billing/subscription`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/billing/subscription`
- Auth: API key in cookie `rove_session`

## Response `200`

Successful response (Cache-Control: no-store)

- object, nullable: The live subscription (not canceled or incomplete_expired), or null. supervised_millicredits_per_minute is the tier rate new supervised sessions snapshot while the status is active, trialing or past_due.
  - `tier` object, required
    - `id` string, required
    - `version` integer, required
    - `name` string, required
  - `status` 'incomplete' | 'trialing' | 'active' | 'past_due' | 'unpaid' | 'paused', required
  - `current_period_end` string, date-time, required
  - `cancel_at_period_end` boolean, required
  - `supervised_millicredits_per_minute` integer, required

## Other responses

- `401`: RFC 7807 owner-session-required: sign in at owner_action_url
- `403`: RFC 7807 owner-origin-refused (mutations only)
- `429`: RFC 7807 purchase-rate-limited: 120 billing reads per minute per account; Retry-After
- `503`: RFC 7807 billing-unavailable; Retry-After: 30, retry same_key

---

[API](https://skmtc.dev/roveapi/apis/rove-api.md) · [All operations](https://skmtc.dev/roveapi/apis/rove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roveapi/apis/rove-api/revisions/0e5d69bde586?raw)