---
title: "Get Account List"
method: POST
path: "/pws/pws_account_list/"
tags: ["Account"]
---

# Get Account List

`POST /pws/pws_account_list/`

<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>
<li class="docBullet">"ac_id" or "cu_id" any one of the parameter needs to be provided. If both fields are provided than "ac_id" will have precedence and response will return  the details of account mentioned in "ac_id" and all accounts where "ac_id" is a parent account</li>
</ul>

## Request body

- AccountListModel — This web service retrieves a list available accounts under a parent account or customer ID. If both ac_id and cu_id is passed in request ac_id is given priority.
  - `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
  - `cu_id` integer — Customer Id to list account of the provided customer.
  - `cu_ref` string — Customer Reference
  - `ac_id` integer — Parent account number Conditional : If any other parameter values are passed, ac_id is optional. Otherwise ac_id is mandatory
  - `ac_ext_ref` string — Account external reference

## Response `200`

Successful Response

- AccountListResponse — This model contains response when we call account list api
  - `header` AccountListHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` AccountListBody[]
    - `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
    - `crd_prdct_id` integer — Card product id. (Need to input correct product id for your card so it will inherit full required properties and be fully linked with business.)
    - `bal_act_amt` number — Actual Balance Amount
    - `cre_dt` string — Created Date
    - `cu_ref` string — Customer Ref

## 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)