---
title: "Get Card list"
method: POST
path: "/pws/pws_card_list/"
tags: ["Card"]
---

# Get Card list

`POST /pws/pws_card_list/`

This web service retrieves a list of all cards linked to an account or parent account

## Request body

- CardListModel — -- This web service retrieves a list of available cards tokens. -- The list is displayed in a hierarchy. Every card linked to an account or parent account is retrieved.
  - `ac_id` integer, required — 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
  - `cu_id` integer — Customer Id
  - `cu_ref` string — Customer Reference

## Response `200`

Successful Response

- CardListResponseModel
  - `header` CardListResponseModelHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` CardListResponseModelBody[]
    - `image_name` string, required — Image template name for the card to be generated.
    - `is_primary` boolean, required — Indicates whether a card is primary or not
    - `ac_id` integer — Account number
    - `token` integer — Public token
    - `status_nwk` integer — <p>Status network :</p> <ul> <li class="docBullet">1000 : Fully operational DE39=00</li> <li class="docBullet">1001 : Refer to issuer DE39=01</li> <li class="docBullet">1004 : Capture card DE39=04</li> <li class="docBullet">1005 : Decline all txns DE39=05</li> <li class="docBullet">1008 : Honour with ID DE39=08</li> <li class="docBullet">1041 : Lost card - capture DE39=41</li> <li class="docBullet">1043 : Stolen card - capture DE39=43</li> <li class="docBullet">1054 : Expired card - report DE39=54</li> <li class="docBullet">1154 : Expire card - don't inform</li> <li class="docBullet">1062 : Restricted card</li> <li class="docBullet">1199 : Void card - report DE39=05</li></ul>
    - `product_id` integer — Product id of card
    - `is_default` integer — Indicates what default account linked with card at multi-card-account hierarchy
    - `is_active_ccy` integer — Active currency at multiple account linkage with card
    - `cre_dt` string — Card/token created date in ISO 8601 format
    - `tran_ccy` string — Transaction currency code. (Three digit ISO-4217 standard currency code . i.e. : 048 → BHD, 060 → BMD, 036 → AUD)
    - `bal_blk_amt` number — Blocked balance amount
    - `bal_act_amt` number — Actual balance amount
    - `cu_ref` string — Customer reference
    - `cu_id` integer — Customer Id
    - `card_type` integer — <ul> <li class="docBullet">1 ==&gt;Physical</li> <li class="docBullet">2 ==&gt; Virtual card</li> <li class="docBullet">3 ==&gt;Converted(Virtual to physical)</li> </ul>

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