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

# Get Usage

> Check current API key usage, remaining quota and prepaid balance.

Send X-API-Key header to identify the key. Free endpoint (no x402 cost).
`balance_usd` is the prepaid balance each priced call is debited from (#434).



## OpenAPI

````yaml /api-reference/openapi.json get /v1/keys/usage
openapi: 3.1.0
info:
  title: LimitGuard.ai
  description: Trust Intelligence API - Entity verification and risk scoring
  version: 0.1.0
servers:
  - url: https://api.limitguard.ai
security: []
paths:
  /v1/keys/usage:
    get:
      summary: Get Usage
      description: >-
        Check current API key usage, remaining quota and prepaid balance.


        Send X-API-Key header to identify the key. Free endpoint (no x402 cost).

        `balance_usd` is the prepaid balance each priced call is debited from
        (#434).
      operationId: get_usage_v1_keys_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeyUsageResponse'
      security:
        - APIKeyHeader: []
components:
  schemas:
    KeyUsageResponse:
      properties:
        key_id:
          type: string
          title: Key Id
          description: Key identifier (SHA-256 hash prefix)
        tier:
          type: string
          title: Tier
          description: Current pricing tier
        monthly_usage:
          type: integer
          title: Monthly Usage
          description: Requests used this billing period
        monthly_limit:
          type: integer
          title: Monthly Limit
          description: >-
            Monthly request ceiling for this tier (an abuse cap, not prepaid
            calls)
        remaining:
          type: integer
          title: Remaining
          description: Requests remaining this period
        usage_percent:
          type: number
          title: Usage Percent
          description: Percentage of quota used (0-100)
        balance_usd:
          type: number
          title: Balance Usd
          description: >-
            Prepaid balance in USD; each priced call is debited at the price in
            the pricing table
          default: 0
      type: object
      required:
        - key_id
        - tier
        - monthly_usage
        - monthly_limit
        - remaining
        - usage_percent
      title: KeyUsageResponse
      description: >-
        Response showing current API key usage, remaining quota and prepaid
        balance.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````