---
title: "Get Card History V2"
method: POST
path: "/pws/v2/pws_card_history/"
tags: ["Card V2"]
---

# Get Card History V2

`POST /pws/v2/pws_card_history/`

This web service gets the full audit history of a card (load card, get balance, set/get status) over a specified time period. Note : List Endpoint does not support's Idempotency.

## Request body

- CardHistoryModelV2
  - `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
  - `page_limit` integer, required — No of rows to return
  - `page_no` integer, required — Page Number
  - `token` integer, required — Public token
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `http_filter` string — <ul> <li class="docBullet">g or G ==&gt; For retrieve actions like (pws_get_balance)</li> <li class="docBullet">p or P ==&gt; For insert,update, delete actions like (pws_load_balance)</li> <li class="docBullet">If not send or its value is null, then retrieves data for both </ul>
  - `text_search` string — Wild card search
  - `card_account` string — <ul> <li class="docBullet">a or A = retrieves account related only</li> <li class="docBullet">c or C =retrieves card related only</li> <li class="docBullet">b or B =retrieves both card and account related</li> </ul>

## Response `200`

Successful Response

- CardHistoryV2ResponseModel
  - `header` Header
    - `error_desc` string, required — Error Description
    - `error_id` integer, required — Error Id
  - `body` CardHistoryV2ResponseModelBody — Response Body
    - `total_records` integer — total records available
    - `data` CardHistoryResponseModelBody[] — Card History Data
      - `api_call_unique_identifier` string — Unique number that must be passed at each API request. Identifier to make each API request unique
      - `request_body` string — API request JSON string
      - `response_body` string — API response JSON string
      - `request_date_time` string — API request date time in format yyyy-MM-ddThh:mm:ss
      - `status` string — Success/Failure status. <ul><li class="docBullet">s=success</li><li class="docBullet">f=failed</li></ul>
      - `api_desc` string — Api Description
      - `client_id` integer — Unique identifier for the client which Paymentology will provide at outset
      - `api_name` string — Api Name

## 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/versions/a675891b0365/schema)