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

# Get a managed connector's balance

> Read the provider's authoritative balance for a managed OpenRouter connector. Only connectors created with the provision endpoint have a balance; bring-your-own-key and OAuth connectors answer 404. Requires an unrestricted token, because the balance is organization-wide financial state.



## OpenAPI

````yaml /sprites/api/openapi.json get /v1/oauth/connections/{id}/balance
openapi: 3.1.0
info:
  title: Sprites API
  version: 0.1.12
  x-sprite-env-version: 0.0.5
servers:
  - url: https://api.sprites.dev
security: []
paths:
  /v1/oauth/connections/{id}/balance:
    get:
      tags:
        - Connectors
      summary: Get a managed connector's balance
      description: >-
        Read the provider's authoritative balance for a managed OpenRouter
        connector. Only connectors created with the provision endpoint have a
        balance; bring-your-own-key and OAuth connectors answer 404. Requires an
        unrestricted token, because the balance is organization-wide financial
        state.
      operationId: connection_usage_balance_get
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionBalanceResponse'
          description: Success
        '401':
          description: Missing or invalid authentication
        '403':
          description: Unrestricted token required
        '404':
          description: Connector not found or not a managed OpenRouter connector
        '502':
          description: The provider's management API failed
      security:
        - bearerAuth: []
components:
  schemas:
    ConnectionBalanceResponse:
      description: Managed connector balance response
      properties:
        balance:
          $ref: '#/components/schemas/ConnectionBalance'
          description: Balance as reported by the provider.
          example:
            disabled: false
            limit_usd: 60
            remaining_usd: 53
            usage_usd: 7
      required:
        - balance
      type: object
    ConnectionBalance:
      description: Managed connector balance
      properties:
        disabled:
          description: Whether the provider has disabled the managed key.
          example: false
          type: boolean
        key_hash:
          description: Provider identifier of the managed key.
          example: sk-or-v1-hash
          type: string
        limit_usd:
          description: >-
            Spend limit on the managed key in USD. Null when the key has no
            limit.
          example: 60
          type:
            - number
            - 'null'
        remaining_usd:
          description: Remaining credit in USD. Null when the key has no limit.
          example: 52.999996
          type:
            - number
            - 'null'
        usage_usd:
          description: Spend recorded by the provider against the managed key in USD.
          example: 7.000004
          type: number
      required:
        - usage_usd
        - disabled
        - key_hash
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````