---
title: "Get credit balance"
method: GET
path: "/payment/v1/credits/balance"
tags: ["Billing"]
---

# Get credit balance

`GET /payment/v1/credits/balance`

Returns the organization's current credit balance in USD plus the
current plan identifier. Organization is resolved from the API key,
so no `X-Organization-Id` header is required.

## Response `200`

Current balance for the caller's organization.

- BillingBalanceResponse
  - `success` boolean, required
  - `data` object, required
    - `creditBalance` number, required — Current credit balance in USD. May be negative if the account has spent past its balance and is on a plan that permits overdraw.
    - `planId` string, required — Identifier for the plan the organization is on.
    - `isEnterprise` boolean, required — True when the organization is on an enterprise plan (billed offline).

## Other responses

- `401` — Unauthorized access

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/9fd13f607823/schema)