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

# Account Balance

> Check your remaining validation credits

The Account Balance endpoint returns the number of remaining validation credits in your DeBounce account.

Use this endpoint to:

* Check available credits before running validations
* Monitor credit usage programmatically
* Prevent interruptions in automated workflows

## Response

The response is a simple JSON object containing only your current credit balance.

Example:

```json theme={null}
{
  "balance": "1087306"
}
```

<Note>
  This endpoint is read-only and always returns the balance as a string value.
</Note>


## OpenAPI

````yaml GET /v1/balance/
openapi: 3.1.0
info:
  title: DeBounce Email Validation API
  description: Single email validation, reverse lookup, balance, and usage endpoints.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.debounce.io
security:
  - ApiKeyQuery: []
paths:
  /v1/balance/:
    get:
      tags:
        - Account Management
      summary: Get account balance
      operationId: getBalance
      parameters:
        - name: api
          in: query
          description: Your DeBounce API key
          required: true
          schema:
            type: apiKey
          example: YOUR API KEY
      responses:
        '200':
          description: Account balance retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResult'
              examples:
                success:
                  summary: Successful balance retrieval
                  value:
                    balance: 1986406
        '401':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                debounce:
                  error: Wrong API
                  code: '0'
                success: '0'
components:
  schemas:
    BalanceResult:
      type: object
      required:
        - success
      properties:
        balance:
          description: Current account balance
          type: integer
          minimum: 0
        success:
          description: Whether the request was successful
          type: integer
          enum:
            - 0
            - 1
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
        message:
          type: string
        debounce:
          type: object
          properties:
            error:
              type: string
            code:
              type: string
        success:
          type: string
          enum:
            - '0'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api
      description: API key for authentication

````