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

# Get account billing details

> Returns the authenticated account’s complete billing summary, including its plan limits, current usage period, available wallet balance, and subscription state. Organization accounts use Driver Billing data. Unmigrated legacy accounts return their wallet balance with `plan`, `period`, and `subscription` set to null.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/account/billing
openapi: 3.0.0
info:
  version: 1.0.0
  title: Driver API
  description: API for interacting with the Driver.dev browser network.
  contact:
    name: Driver support
    email: alex@driver.dev
servers:
  - url: https://api.driver.dev
    description: Production
security: []
tags:
  - name: Sessions
  - name: Profiles
  - name: Account
  - name: Extensions
  - name: Pools
externalDocs:
  url: https://docs.driver.dev
  description: Driver documentation
paths:
  /v1/account/billing:
    get:
      tags:
        - Account
      summary: Get account billing details
      description: >-
        Returns the authenticated account’s complete billing summary, including
        its plan limits, current usage period, available wallet balance, and
        subscription state. Organization accounts use Driver Billing data.
        Unmigrated legacy accounts return their wallet balance with `plan`,
        `period`, and `subscription` set to null.
      responses:
        '200':
          description: Complete billing details for the authenticated account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingDetails'
        '401':
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                required:
                  - error
        '404':
          description: Account not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                required:
                  - error
        '500':
          description: Billing details could not be returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                required:
                  - error
      security:
        - Bearer: []
components:
  schemas:
    BillingDetails:
      type: object
      properties:
        orgId:
          type: string
          nullable: true
          description: WorkOS organization ID. Null for an unmigrated legacy account.
        status:
          type: string
          description: Billing account status. Legacy accounts return `legacy`.
        plan:
          $ref: '#/components/schemas/BillingPlan'
        period:
          $ref: '#/components/schemas/BillingPeriod'
        wallet:
          $ref: '#/components/schemas/BillingWallet'
        subscription:
          $ref: '#/components/schemas/BillingSubscription'
      required:
        - orgId
        - status
        - plan
        - period
        - wallet
        - subscription
      example:
        orgId: org_01KNRFX3833MCT6CX3R9AWR4Z8
        status: active
        plan:
          plan_key: advanced
          display_name: Advanced
          price_monthly_cents: 4900
          included_network_mb: 100000
          overage_millicents_per_mb: 250
          concurrent_browsers: 20
          max_session_seconds: 3600
        period:
          start_ms: 1782864000000
          end_ms: 1785542400000
          included_network_mb: 100000
          network_mb_used: 12500
          network_mb_remaining: 87500
        wallet:
          balance_cents: 1250
          balance_millicents: 1250000
        subscription:
          subscription_id: sub_example
          provider: polar
          status: active
          current_period_start: 1782864000000
          current_period_end: 1785542400000
          cancel_at_period_end: false
    BillingPlan:
      type: object
      nullable: true
      properties:
        plan_key:
          type: string
          description: Stable billing plan identifier.
          example: advanced
        display_name:
          type: string
          description: Human-readable plan name.
          example: Advanced
        price_monthly_cents:
          type: integer
          minimum: 0
          description: Monthly plan price in cents.
          example: 4900
        included_network_mb:
          type: number
          minimum: 0
          description: Network traffic included with the plan, in megabytes.
          example: 100000
        overage_millicents_per_mb:
          type: number
          minimum: 0
          description: >-
            Network overage rate in millicents per megabyte; 1,000 millicents
            equals one cent.
          example: 250
        concurrent_browsers:
          type: integer
          minimum: 0
          description: Concurrent browser allowance provided by the plan.
          example: 20
        max_session_seconds:
          type: integer
          minimum: 0
          description: Maximum duration of one browser session, in seconds.
          example: 3600
      required:
        - plan_key
        - display_name
        - price_monthly_cents
        - included_network_mb
        - overage_millicents_per_mb
        - concurrent_browsers
        - max_session_seconds
      description: Current plan, or null for an unmigrated legacy account.
    BillingPeriod:
      type: object
      nullable: true
      properties:
        start_ms:
          type: integer
          minimum: 0
          description: Current billing period start as Unix epoch milliseconds.
        end_ms:
          type: integer
          minimum: 0
          description: Current billing period end as Unix epoch milliseconds.
        included_network_mb:
          type: number
          minimum: 0
          description: Network traffic included in this billing period, in megabytes.
        network_mb_used:
          type: number
          minimum: 0
          description: >-
            Metered network traffic used during this billing period, in
            megabytes.
        network_mb_remaining:
          type: number
          description: >-
            Included network traffic remaining in this billing period, in
            megabytes.
      required:
        - start_ms
        - end_ms
        - included_network_mb
        - network_mb_used
        - network_mb_remaining
      description: Current usage period, or null for an unmigrated legacy account.
    BillingWallet:
      type: object
      properties:
        balance_cents:
          type: number
          description: >-
            Available wallet balance in cents. This can be negative when usage
            exceeds prepaid credit.
        balance_millicents:
          type: number
          description: >-
            Available wallet balance in millicents for exact billing
            calculations; 1,000 millicents equals one cent.
      required:
        - balance_cents
        - balance_millicents
      description: Current prepaid wallet balance.
    BillingSubscription:
      type: object
      nullable: true
      properties:
        subscription_id:
          type: string
          description: Billing provider subscription identifier.
        provider:
          type: string
          nullable: true
          enum:
            - polar
            - nowpayments
          description: Subscription billing provider when applicable.
        status:
          type: string
          description: Current subscription lifecycle status.
          example: active
        current_period_start:
          type: integer
          minimum: 0
          description: Subscription period start as Unix epoch milliseconds.
        current_period_end:
          type: integer
          minimum: 0
          description: Subscription period end as Unix epoch milliseconds.
        cancel_at_period_end:
          type: boolean
          description: >-
            Whether the subscription is scheduled to cancel at the end of its
            current period.
      required:
        - subscription_id
        - status
        - current_period_start
        - current_period_end
        - cancel_at_period_end
      description: Current subscription, or null when the account has no subscription.
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: >-
        A workspace API key from Settings → API keys in the dashboard
        (https://app.driver.dev), sent as a bearer token.

````