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

# Current balance and top-up pricing



## OpenAPI

````yaml /openapi.yaml get /v1/billing
openapi: 3.1.0
info:
  title: Impossibl AI API
  version: 0.0.1
  description: >
    The Impossibl AI API is one API for all AI providers, OpenAI-compatible
    across OpenAI,

    Anthropic, Google, xAI, and more (`GET /v1/models` lists the full catalog),

    billed from a prepaid credit balance.


    Usage is billed at the model rates published by GET /v1/models with no usage
    markup.

    Prepaid credit purchases charge a separate fixed 5% platform fee before tax.


    **Get started**

    Create a workspace key at https://impossibl.com/dashboard, then call a model
    with

    `Authorization: Bearer <key>` and a full model ID from `GET /v1/models`.

    The walkthrough is at https://impossibl.com/docs/quickstart.


    Agents can create a funded account and initial key with `POST /v1/accounts`.

    The current API continues to use `/v1`; there is no `/v2` base URL.

    Conversation history is managed by your application. Provider-specific SDK

    endpoints and fields outside this specification are not guaranteed
    compatible.
servers:
  - url: https://api.impossibl.com
    description: Production
  - url: http://localhost:8787
    description: Local dev
security:
  - BearerKey: []
paths:
  /v1/billing:
    get:
      summary: Current balance and top-up pricing
      operationId: getBilling
      responses:
        '200':
          description: Balance, fixed top-up fee, provider-usage markup, and Stripe status
          content:
            application/json:
              schema:
                type: object
                properties:
                  balance:
                    $ref: '#/components/schemas/Balance'
                  min_topup_usd:
                    type: number
                    example: 5
                  platform_fee_rate:
                    type: number
                    const: 0.05
                    description: Fixed fee added to net prepaid credit purchases
                  usage_price_markup:
                    type: number
                    example: 1
                    description: >-
                      Current provider-usage multiplier; production uses 1 for
                      no usage markup
                  stripe_configured:
                    type: boolean
components:
  schemas:
    Balance:
      type: object
      properties:
        credits:
          '0': null
          type: integer
          description: micro-USD (1
          000 = $1): null
        usd:
          type: number
  securitySchemes:
    BearerKey:
      type: http
      scheme: bearer
      description: Gateway API key (`imp-rt-...`) from POST /v1/accounts or /v1/keys.

````

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