---
title: "Getting Account Balance"
method: GET
path: "/v1/account/balance"
---

# Getting Account Balance

`GET /v1/account/balance`

## Request

- Base URL: `https://apis.cequens.com/sms`
- URL: `https://apis.cequens.com/sms/v1/account/balance`
- Auth: API key in header `Authorization`

Through Get Your Current Balance API, you can directly retrieve your current Cequens account balance. You can also get the current balance of your sub-accounts, along with their details, in case your account is a master account.

Using Cequens Get Your Current Balance API is quite simple. First, submit an HTTP Request to the API’s designated URL, and then receive a Response that includes your account balance details.

## Response `200`

200

- object
  - `replyCode` integer
  - `replyMessage` string
  - `requestId` string
  - `clientRequestId` integer
  - `requestTime` string
  - `data` object
    - `Account` object
      - `UserName` string
      - `Credit` integer
    - `SubAccounts` object[]
      - `UserName` string
      - `Credit` integer
      - `BalanceMode` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/cequens/apis/sms.md) - [All operations](https://skmtc.dev/cequens/apis/sms/llms.txt) - [OpenAPI document](https://skmtc.dev/cequens/apis/sms/revisions/def8ba992ae2?raw)