---
title: "Return current credit balance for the caller's company"
method: GET
path: "/credits/balance"
tags: ["credits"]
---

# Return current credit balance for the caller's company

`GET /credits/balance`

## Request

- Base URL: `https://api.autron.ai`
- URL: `https://api.autron.ai/credits/balance`
- Auth: API key in header `Authorization`

Response shape:
    {
      "status": "success",
      "balance": {
        "company_public_id": "...",
        "included": 1000,
        "balance": "734.5000",
        "period_start": "2026-05-14T00:00:00+00:00",
        "period_end":   "2026-06-14T00:00:00+00:00",
        "updated_at":   "2026-05-14T18:24:00+00:00"
      }
    }

When the caller's company has no credit_balance row yet (no
active credits-tier subscription), ``balance`` is ``null`` and
the agent app interprets that as "free tier".

## Response `200`

Success

---

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