> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rigbox.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscription status

> Read your plan, add-ons, deadlines and wallet. Readable with an API key.

> [!NOTE]
>
> Readable with an API key, so scripts and `rig limits` / `rig whoami` can show billing state. See [pricing and billing](https://docs.rigbox.dev/concepts/pricing-and-billing.md#integration-and-retry-behavior).

Read the confirmed plan, paid-through deadline, transition deadline, pending change, add-ons, and wallet projection. A pending plan or browser checkout success does not increase confirmed quota. Compute authorization comes from the limits projection, not a status label alone. The generated response schema is generic JSON.

Account billing requires an authenticated account identity with appropriate billing permissions. Workspace bridge identity is not an account billing credential. See [managed wallet](https://docs.rigbox.dev/ai/managed-wallet.md) for the financial contract.


## OpenAPI

````yaml openapi/auth-api.json GET /api/v1/auth/subscription-status
openapi: 3.1.0
info:
  title: Rigbox Auth API
  description: Auth-service-owned public API surface exported for gateway composition.
  contact:
    name: Rigbox
    url: https://rigbox.dev
  license:
    name: ''
  version: 1.0.0
servers:
  - url: https://api.rigbox.dev
    description: Production gateway
security: []
tags:
  - name: Auth
  - name: Account
  - name: GitHub Deployments
  - name: API Keys
  - name: Access Control
paths:
  /api/v1/auth/subscription-status:
    get:
      tags:
        - Auth
      operationId: status
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema: {}
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.