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

# List Credit History

> Retrieve credit usage history

## Overview

Retrieve credit usage history. This endpoint returns detailed information about your credit usage over time, including daily usage, remaining credits, and period summaries.


## OpenAPI

````yaml GET /billing/credit-history
openapi: 3.1.0
info:
  title: Ledgerbeam API
  description: >-
    Conversational analytics API for querying data using natural language,
    managing resources, and interacting with data sources
  version: 1.0.0
  contact:
    name: Ledgerbeam Support
    email: support@ledgerbeam.com
  license:
    name: MIT
servers:
  - url: https://api.ledgerbeam.com/v1
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /billing/credit-history:
    get:
      summary: List credit history
      description: Retrieve credit usage history
      operationId: listCreditHistory
      responses:
        '200':
          description: Credit history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreditHistoryResponse'
components:
  schemas:
    CreditHistoryResponse:
      type: object
      properties:
        next_cursor:
          type: string
          description: Pagination cursor for next page
          example: XjdHaksD
        data:
          type: array
          items:
            $ref: '#/components/schemas/CreditUsage'
          description: List of credit usage records
        summary:
          type: object
          properties:
            total_credits_used:
              type: integer
              description: Total credits used
              example: 5000
            current_credits:
              type: integer
              description: Current available credits
              example: 500
            period_start:
              type: string
              format: date
              description: Period start date
              example: '2024-01-01'
            period_end:
              type: string
              format: date
              description: Period end date
              example: '2024-01-31'
    CreditUsage:
      type: object
      properties:
        date:
          type: string
          format: date
          description: Usage date
          example: '2024-01-15'
        credits_used:
          type: integer
          description: Credits used on this date
          example: 150
        credits_remaining:
          type: integer
          description: Credits remaining
          example: 850
        total_credits:
          type: integer
          description: Total credits for the period
          example: 1000
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: API-KEY
      description: API key for authentication

````