---
title: "Get account balance"
method: GET
path: "/public/v2/billing/balance"
tags: ["Billing"]
---

# Get account balance

`GET /public/v2/billing/balance`

Required permission: Financial, View.<br/>Response contains one balance for each currency. If all balances are 0 then response will contain a single entry with 0 balance and currency matching the default for this account.

## Response `200`

Balance retrieved

- AccountBalanceResponseServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` AccountBalanceResponse
    - `balances` CurrencyBalanceResponse[] — The account balance for each currency owed. If nothing is owed, a single zero balance in the account's currency is returned.
      - `currency` string — The ISO 4217 alphabetic currency code of the balance. Example: USD
      - `dueAmount` number, double — The amount due

## Other responses

- `401` — Unauthorized
- `403` — Missing required permission for this endpoint or resource
- `422` — Failed to retrieve the balance

---

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