---
title: "Get Credit Balance"
method: GET
path: "/v0/billing/credit-balance"
tags: ["Billing"]
---

# Get Credit Balance

`GET /v0/billing/credit-balance`

## Request

- Base URL: `https://api.theirstack.com`
- URL: `https://api.theirstack.com/v0/billing/credit-balance`
- Auth: HTTP bearer

Retrieve your team's current credit balance including remaining credits available for API calls, searches, and data exports across all endpoints.

## Response `200`

Successful Response

- CreditsBalance
  - `ui_credits` integer, required: Number of credits available to the team
  - `used_ui_credits` integer, required: Number of credits used in the current billing cycle
  - `api_credits` integer, required: Number of API credits available to the team
  - `used_api_credits` integer, required: Number of API credits used in the current billing cycle
  - `earliest_expiration` string, date-time, nullable: Earliest expiration date among invoices with remaining credits

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-05-10** `1dae359ce2c7`: 1 info
  - added the optional property `earliest_expiration` to the response with the `200` status
- **2026-01-14** `ecd1eb029865`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/billing/credit-balance/get.md)

---

[API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) - [All operations](https://skmtc.dev/theirstack/apis/theirstack-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/theirstack/apis/theirstack-api-reference/revisions/4f3da5ce4026?raw)