---
title: "Get Credit Balance"
method: GET
path: "/credits/balance"
tags: ["Account"]
---

# Get Credit Balance

`GET /credits/balance`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/credits/balance`
- Auth: HTTP bearer

Retrieves the current account's available credit balance and expected next recurring credit grant time.

The balance is a near-real-time hint and can lag one in-flight metered operation. A `402`
response from an operation is authoritative when deciding whether more credits are required.
Negative ledger balances are returned as `0` available credits.

`next_grant_at` comes from the account's billing schedule, not an existing grant's expiration.
It is null when no scheduled grant can be determined. Processing may occur later, and other
grants may arrive sooner.

## Requires api token with one of the following permissions
```
(any scope allowed)
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. The account is always derived
from the authenticated token; this endpoint does not accept an account identifier.

[Expiring access tokens](https://docs.wistia.com/reference/post_expiring-token)
created with authorizations cannot be used: this endpoint responds with a
403, whatever the authorizations grant.

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Successful response

- object: The current account's available Credits balance and expected next recurring grant date.
  - `balance` string, required: Available Credits as an exact, nonnegative decimal string.
  - `next_grant_at` string, date-time, nullable, required: Expected next recurring Credits grant boundary from the account's billing schedule, as an ISO 8601 timestamp. Null when no scheduled grant can be determined. Processing may occur later, and other grants may arrive sooner.

## Other responses

- `401`: Unauthorized, invalid or missing token
- `403`: Forbidden, token is valid but account does not have access to feature
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/credits/balance/get.md)

---

[API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)