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

# Get Card History

`POST /pws/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

## Request body

- CardHistoryModel — -- This web service gets the history of a card/token. -- It serves as an audit log by saving the life cycle of a card from creation to activities, like load card, get balance, set/get status 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
  - `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

- CardHistoryResponseModel
  - `header` Header
    - `error_desc` string, required — Error Description
    - `error_id` integer, required — Error Id
  - `body` CardHistoryResponseModelBody[]
    - `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/revisions/a675891b0365/schema)