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

# Get account balance

`GET /public/v2/billing/balance`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/billing/balance`
- Auth: HTTP bearer

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.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)