---
title: "Get the credit balance"
method: GET
path: "/credits/balance"
tags: ["credits"]
---

# Get the credit balance

`GET /credits/balance`

## Request

- Base URL: `https://api.voixcall.com/v1`
- URL: `https://api.voixcall.com/v1/credits/balance`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.voixcall.com/oauth/authorize`, token URL `https://api.voixcall.com/oauth/token`, scopes: `credits:read`)
  - HTTP bearer

The account's available credit. billing_url is where the user adds credits, inside VoixCall. Test keys see a separate test balance seeded at 10.00. Requires credits:read.

## Response `200`

OK

- Balance
  - `amount` string, required: Available credit, decimal string with two decimals.
  - `billing_url` string, uri, required: Where to add credits; opens the app or the web dashboard after login.
  - `currency` 'USD', required
  - `livemode` boolean, required
  - `low_balance` boolean, required: true when the balance is below the account's low-balance threshold.
  - `object` 'balance', required: Always "balance".

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/voixcall/apis/voixcall-api.md) · [All operations](https://skmtc.dev/voixcall/apis/voixcall-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voixcall/apis/voixcall-api/revisions/9aac329ff0f5?raw)