---
title: "List Transaction"
method: POST
path: "/pws/pws_transaction_list/"
tags: ["Transaction"]
---

# List Transaction

`POST /pws/pws_transaction_list/`

This web service retrieves back transaction list based on various filter applied. Filters  : token, transaction type, transaction spend type, date etc

## Request body

- TransactionListModel — This web service retrieves back transaction list based on various filter applied Filters : token, transaction type, transaction spend type, date etc
  - `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
  - `date_from` string, required — From Date,accepted format yyyy-mm-dd hh:mm:ss.
  - `date_to` string, required — To Date,accepted format yyyy-mm-dd hh:mm:ss.
  - `txn_type_list` string, required — <p>transaction Type value can be accpeted in Comma separated form. Following are the type that can be accepted:</p> <br /><ul> <li class="docBullet"> Au = Authorization.</li><li class="docBullet">Ad = Advisement.</li><li class="docBullet">Re = Reversals.</li><li class="docBullet">Se = Settlement.</li><li class="docBullet">Cb = chargeback.</li><li class="docBullet">Lo = Load.</li><li class="docBullet">Un = UnLoad.</li><li class="docBullet">Ra = rules applied.</li></ul>
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `t_status_list` string — Transaction status. This field allows you to further specify the transaction list you wish to be returned. For example, you may want to only show approved spends that have been partially reversed. Then your value input would be 11. This field is optional. Value can be accepted in comma separated. Following are the list of values that can be accepted: <ul> <li class="docBullet">1 = Normal Spend-Approved (not Settled)</li> <li class="docBullet">2 = Normal Spend-Declined </li> <li class="docBullet">3 = Normal Spend-Approved then Reversed</li> <li class="docBullet">4 = Zero Amt Auth (bal/pin change etc)-Approved</li> <li class="docBullet">5 = Zero Amt Auth (bal/pin change etc)-Declined</li> <li class="docBullet">10 = Normal Spend-Declined then Partial Reversal</li> <li class="docBullet">11 = Normal Spend-Approved then Partial Reversal</li> <li class="docBullet">12 = Normal Partial Spend-Approved not Settled</li> <li class="docBullet">14 = Normal Spend-Approved then Unblocked</li> <li class="docBullet">15 = Normal Spend-Approved then Unblocked Failed</li> <li class="docBullet">16 = Normal Spend-Approved then Advisement</li> <li class="docBullet">17 = ATM Approved & Settled</li> <li class="docBullet">18 = ATM -Declined</li> <li class="docBullet">19 = Normal Spend - Declined then Advisement</li> <li class="docBullet">20 = Reversal-Manual unblock (Paymentology generated)</li> <li class="docBullet">21 = Reversal-Auto Unblock (Paymentology generated)</li> <li class="docBullet">24 = Reversal-Scheme delivered-Approved</li> <li class="docBullet">25 = Reversal-Scheme delivered-Declined</li> <li class="docBullet">26 = Reversal-Partial- Scheme delivered-Approved</li> <li class="docBullet">30 = Advisement-Approved Spend, preceeding spend exists (Balance impacting)</li> <li class="docBullet">31 = Advisement-Approved Spend (Not balance impacting)</li> <li class="docBullet">32 = Advisement-Approved Spend, No preceeding spend (balance impacting)</li> <li class="docBullet">35 = Advisement-Reversal (0420), preceeding spend exists (Balance impacting)</li> <li class="docBullet">36 = Advisement-Reversal (0420), No preceeding spend (Not balance impacting)</li> <li class="docBullet">37 = Reversal-Manual unblock (Paymentology generated)</li> <li class="docBullet">38 = Reversal-Auto Unblock (Paymentology generated)</li> <li class="docBullet">501 = Normal Spend-Approved-Now Settled</li> <li class="docBullet">502 = Normal Spend-Declined-Now Settled</li> <li class="docBullet">503 = Normal Spend-Approved then Reversed-Now Settled</li> <li class="docBullet">504 = Zero Amt Auth (bal/pin change etc)-Approved-Now Settled</li> <li class="docBullet">505 = Zero Amt Auth (bal/pin change etc)-Declined-Now Settled</li> <li class="docBullet">510 = Normal Spend-Declined then Partial Reversal-Now Settled</li> <li class="docBullet">511 = Normal Spend-Approved then Partial Reversal-Now Settled</li> <li class="docBullet">524 = Reversal-Scheme delivered-Approved-Now Settled</li> <li class="docBullet">525 = Reversal-Scheme delivered-Declined-Now Settled</li> <li class="docBullet">530 = Advisement-Approved Spend, preceeding spend exists (Balance impacting)-Now Settled</li> <li class="docBullet">531 = Advisement-Declined Spend (Not balance impacting)-Now Settled</li> <li class="docBullet">532 = Advisement-Approved Spend, No preceeding spend (balance impacting)-Now Settled</li> <li class="docBullet">535 = Advisement-Reversal (0420), preceeding spend exists (Balance impacting)-Now Settled</li> <li class="docBullet">536 = Advisement-Reversal (0420), No preceeding spend (Not balance impacting)-Now Settled</li> <li class="docBullet">1000 = Settlement-No preceeding spend</li> <li class="docBullet">1001 = Settlement-Full match to spend</li> <li class="docBullet">1002 = Settlement-Partial match to spend</li> <li class="docBullet">1005 = Settlement-Auth had been declined</li> <li class="docBullet">1006 = Settlment-Advisement had been declined</li> <li class="docBullet">1007 = Settlement-No auth, just reversal received</li> <li class="docBullet">1010 = Settlement reversed by a settlement reversal</li> <li class="docBullet">1011 = Settlement reversal (reversed a preceeding settlement)</li> <li class="docBullet">1012 = Settlement reversal (No preceeding settlemnt found)</li> <li class="docBullet">1030 = Load-Settled</li> <li class="docBullet">1031 = Unload-Settled</li> <li class="docBullet">1035 = Balance transfer (out) Settled</li> <li class="docBullet">1036 = Balance transfer (in)-Settled</li></ul>
  - `spend_type_list` string — <p>transaction spend type comma separated values accepted</p> <ul> <li class="docBullet">00 = Normal Purchase DE3_1</li> <li class="docBullet">01 = ATM Withdrawal DE3_1</li> <li class="docBullet">09 = Purchase with Cashback DE3_1</li> <li class="docBullet">17 = Cash Disbursement DE3_1</li> <li class="docBullet">20 = Purchase Refund DE3_1</li> <li class="docBullet">28 = Payment transaction(Credit) DE3_1</li> <li class="docBullet">30 = Balance Enquiry DE3_</li> <li class="docBullet">40 = account Transfer DE3_1</li> <li class="docBullet">91 = pin Unblock DE3_1</li> <li class="docBullet">92 = pin Change DE3_1</li> <li class="docBullet">93 = card on file Token Processing DE3_1</li> </ul>
  - `token` integer — Public token for the card
  - `ac_id` integer — Account Id
  - `txn_id` integer — transaction id. If provided retrieves back the transaction data for specific transaction only

## Response `200`

Successful Response

- TransactionListResponseModel
  - `header` ResponseHeader
    - `error_id` integer — Error Id
    - `error_desc` string — Error Message
  - `body` TransactionListResponseModelBody[]
    - `id` integer — Auto increment unique id for transaction
    - `txn_id` integer — Unique transaction id calculated using de7, de32 and de11 and some combinations
    - `type` string — Type of transaction. Eg : Authorization, Settlement etc
    - `txn_status` string — transaction status.
    - `token` integer — Public Token
    - `ac_id` integer — account Id
    - `central_date` string — Central Date
    - `local_date` string — Local Date
    - `source` string — Source of transaction
    - `country` string — Country where transaction occurred
    - `city` string — City where transaction occurred
    - `loc_ccy` string — Currency code of location
    - `loc_amt` number — Location amount
    - `bill_ccy` string — Billing currency
    - `bill_amt` number — Billing amount
    - `settle_bal` number — Settlement balance
    - `block_amount` number — Blocked balance
    - `avl_bal` number — Available amount
    - `advanced_detail` string — Advanced Detail
    - `prod_name` string — product Name
    - `txn_stat_id` integer — Id for transaction status
    - `txn_type` integer — id for transaction type
    - `tc_id` integer — transaction core id
    - `additional_data` string — Additional data
    - `rsn_code` string — Reason code
    - `type_detail` string — Cardholder transaction type code

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