---
title: "Get your credit balance"
method: GET
path: "/v1/account/balance"
tags: ["Account"]
---

# Get your credit balance

`GET /v1/account/balance`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/account/balance`
- Auth: HTTP bearer

Returns the current credit balance for the authenticated API key.

## Response `200`

Credit balance retrieved

- AccountBalanceResponseDto
  - `data` AccountBalanceDataDto, required
    - `balance` string, required: Dollar balance as a display string (1 credit = $0.01).
    - `credits_remaining` number, required
    - `status` 'active' | 'zero_balance', required

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)