---
title: "Get your company's credit balance"
method: GET
path: "/subscriptions/credits/balance"
tags: ["Subscriptions"]
---

# Get your company's credit balance

`GET /subscriptions/credits/balance`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/subscriptions/credits/balance`
- Auth: HTTP bearer

## Response `200`

- CreditBalance
  - `id` string, uuid
  - `companyId` string, uuid
  - `includedBalance` integer, required
  - `purchasedBalance` integer, required
  - `currentPeriodStart` string, date-time, nullable
  - `currentPeriodEnd` string, date-time, nullable
  - `updatedAt` string, date-time
  - `consumedThisPeriod` integer, required: Ledger sum of consumption transactions since currentPeriodStart (or the start of the current UTC calendar month).

## Other responses

- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: No company

---

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