---
title: "Account Balance List"
method: POST
path: "/pws/v2/pws_get_balances/"
tags: ["Account V2"]
---

# Account Balance List

`POST /pws/v2/pws_get_balances/`

<ul>
<li class="docBullet">Allows for retrieval of a list of all child accounts of an account or list all account of provided customer id.</li>
<li class="docBullet">A simple list of all child account id’s and their names, descriptions and billing currencies are returned.</li>
</ul>

## Request body

- AccountBalanceModelV2
  - `ac_id` integer, required — Parent account number
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `option` integer — <ul> <li>1 : Show aggregrate balances for ac_id passed and its child accounts</li> <li>2 : Show aggregate balance for ac_id passed only and its details</li> <li>3 : Show aggregate balance for ac_id and its child accounts and details of all accounts<br /><br /><br /></li> </ul>If value for this field is not passed then action behaves as option 1 by default

## Response `200`

Successful Response

- AccountBalanceResponseV2
  - `header` AccountListHeaderHeader — AccountListHeader Header
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `blk_amt_aggregate` number — Aggregate blocked amount of account list
  - `act_amt_aggregate` number — Aggregate actual amount of account list
  - `body` AccountListBodyBody[]
    - `ac_id` integer — account Id
    - `ac_name` string — account Name
    - `ac_parent` integer — Parent account Id
    - `ac_ext_ref` string — account External Reference
    - `client_id` integer — client id of account
    - `bill_ccy` string — Currency Code
    - `bal_blk_amt` number — Blocked Balance Amount
    - `bal_act_amt` number — Actual Balance Amount
    - `cre_dt` string — Created Date

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)