---
title: "Get Assistant Balance"
method: GET
path: "/api/assistant/balance"
tags: ["Assistant"]
---

# Get Assistant Balance

`GET /api/assistant/balance`

Retrieve the current balance/usage information for the AI assistant.

## Response `200`

Current assistant balance and usage information

- ModelUsage — Usage statistics after deducting the costs of the message.
  - `credits` integer — The number of credits remaining after this message.
  - `input_tokens` integer — The number of input tokens used.
  - `output_tokens` integer — The number of output tokens used.

## Other responses

- `401` — Request was not properly authenticated
- `403` — Insufficient permissions for this request
- `500` — Internal SOC error; review SOC logs

## Changes

- **2026-02-27** `c7b650ad3d3e` — 2 info
  - the security scope `assistant/read_authored` was added to the endpoint's security scheme `bearer`
  - the security scope `assistant/read_all` was removed from the endpoint's security scheme `bearer`
- **2025-12-15** `512723525b00` — 2 info
  - the security scope `assistant/read_authored` was added to the endpoint's security scheme `bearer`
  - the security scope `assistant/read_all` was removed from the endpoint's security scheme `bearer`
- **2025-11-06** `2efaaeaad2a6` — 2 info
  - the security scope `assistant/read_authored` was added to the endpoint's security scheme `bearer`
  - the security scope `assistant/read_all` was removed from the endpoint's security scheme `bearer`
- **2025-10-23** `ab13f6acde20` — 2 info
  - the security scope `assistant/read_authored` was added to the endpoint's security scheme `bearer`
  - the security scope `assistant/read_all` was removed from the endpoint's security scheme `bearer`
- **2025-10-23** `dd1538426ed4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api/changes/api/assistant/balance/get.md)

---

[API](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api.md) · [All operations](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/security-onion-solutions/apis/security-onion-connect-api/revisions/c7b650ad3d3e?raw)