> ## 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.

# Wallet history

> Read your recent managed wallet ledger entries. 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 latest 100 account-owned ledger entries, newest first. Funding, charge, and hold changes have different meanings: `credits` changes wallet balance and `held_delta` changes reserved funds. Historical grant and purchase labels do not prove a remaining purchased-versus-included allocation. Fractional and negative values must be preserved. 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/billing/wallet/history
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/billing/wallet/history:
    get:
      tags:
        - Auth
      operationId: wallet_history
      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.