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

# Get API key credit balance

> Returns the current balance and daily spend information for the authenticated API key, including per-key daily cap and effective available credits.



## OpenAPI

````yaml get /v1/credits/balance
openapi: 3.0.0
info:
  title: HTTPayer Proxy API
  version: 1.0.0
  description: >-
    HTTPayer is a payment router for 402 response codes and the x402 Protocol.
    Users can access APIs that use the x402 standard through the HTTPayer proxy.
  contact:
    name: HTTPayer Team
    url: https://httpayer.com
servers:
  - url: https://api.httpayer.com
    description: Production server
security: []
tags:
  - name: Relay
    description: Cross-chain payment relay endpoints
  - name: Account
    description: Account balance and limits endpoints
  - name: Webhooks
    description: Async task status and webhooks
  - name: LLM
    description: OpenAI-powered endpoints for translation and chat
  - name: Health
    description: Health check endpoints
paths:
  /v1/credits/balance:
    get:
      tags:
        - Credits
      summary: Get API key credit balance
      description: >-
        Returns the current balance and daily spend information for the
        authenticated API key, including per-key daily cap and effective
        available credits.
      parameters: []
      responses:
        '200':
          description: API key balance information
          content:
            application/json:
              schema:
                type: object
                properties:
                  key_prefix:
                    type: string
                    description: The API key prefix
                    example: sk-live-abcd1234
                  daily_cap:
                    type: integer
                    description: Maximum credits this key can spend per day
                    example: 50
                  daily_spent:
                    type: integer
                    description: Credits spent by this key today
                    example: 12
                  daily_remaining:
                    type: integer
                    description: Credits remaining for today (daily_cap - daily_spent)
                    example: 38
                  effective_available:
                    type: integer
                    description: Actual available credits (org credit balance)
                    example: 38
        '401':
          description: Unauthorized - invalid API key
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````