---
title: "Get account balance with free messages"
method: GET
path: "/account/1/total-balance"
tags: ["platform", "account-management", "balance"]
---

# Get account balance with free messages

`GET /account/1/total-balance`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/account/1/total-balance`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Returns the current account balance, monthly balance, monthly and total credit limit, currency details, and the remaining count of free messages per service type.

## Response `200`

OK

- 66067ae938b1b756af79ad29184e7a22de98929ca991ca01a0c74d258f22a0b6BalanceInfoResponse
  - `balance` number
  - `allowedMinus` number
  - `monthlyLimit` number
  - `monthlyBalance` number
  - `currency` 66067ae938b1b756af79ad29184e7a22de98929ca991ca01a0c74d258f22a0b6SimpleCurrencyInfo
    - `id` integer
    - `code` string
    - `currencyName` string
    - `symbol` string
  - `freeMessages` object

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)