> For the complete documentation index, see [llms.txt](https://prepaidify.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prepaidify.gitbook.io/docs/physical-card/api-integration/bank-card-transaction-details-query.md).

# Bank Card Transaction Details Query

### POST Bank Card Transaction Details Query

POST /api/mastercard/masterCardTradeList.html

Bank card transaction details query: Maximum 30 records, default 10. Start is the starting line number, starting from 0 by default.

> Request Body

```
```

```json
{
  "beginDate": "2023-07-01",
  "cardId": "card123456",
  "cardNo": "1234567890",
  "currency": "EUR",
  "endDate": "2023-07-31",
  "maxSize": 10,
  "randomStr": "abcdef1234567890",
  "start": 0,
  "tradeStatus": "ALL",
  "tradeType": 120
}
```

#### Request Parameters

| Name        | Type   | Required | Base64 Encoded | Field Name           | Description                                                                                                                                                                                           |
| ----------- | ------ | -------- | -------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| cardId      | string | false    | none           | card token           | cardId or cardNo must be filled in at least                                                                                                                                                           |
| cardNo      | string | false    | none           | card number          | cardId or cardNo must be filled in at least                                                                                                                                                           |
| tradeStatus | string | false    | none           | transaction status   | Query all successful transactions, fixed value: ALL (If not passed, it defaults to query the final successful transaction, including successful and returned transactions with tradeStatus = 1 or 10) |
| currency    | string | false    | none           | transaction currency | Transaction currency, EUR/USDT by default: EUR                                                                                                                                                        |
| beginDate   | string | true     | none           | begin date           | Start date of the transaction (yyyy-MM-dd) (The maximum interval between start and end dates is 30 days)                                                                                              |

> Example Response
>
> 200 Response

```
```

```json
{
    "total": 0,
    "tradeList": [
      {
        "cardNo": "string",
        "currency": "string",
        "amount": 0,
        "fee": 0,
        "currencyTxn": "string",
        "txnAmount": 0,
        "businessDate": "string",
        "tradeId": "string",
        "authCode": "string",
        "tradeType": 0,
        "tradeStatus": 0,
        "remark": "string"
      }
    ]
}
```

#### Response Fields

| Name      | Type    | Required | Constraint | Field Name         | Description                                    |
| --------- | ------- | -------- | ---------- | ------------------ | ---------------------------------------------- |
| total     | integer | true     | none       | Total Transactions | Total Number of Transactions within Date Range |
| tradeList | array   | true     | none       | Transaction List   | Transaction Details List                       |

The parameters contained in the tradeList are as follows:

| Name         | Type   | Required | Constraint | Description                 |
| ------------ | ------ | -------- | ---------- | --------------------------- |
| cardNo       | string | true     | none       | Card number                 |
| currency     | string | true     | none       | Currency                    |
| amount       | number | true     | none       | Transaction amount          |
| fee          | number | true     | none       | Transaction fee             |
| currencyTxn  | string | true     | none       | Actual transaction currency |
| txnAmount    | number | true     | none       | Actual transaction amount   |
| businessDate | string | true     | none       | Business date               |
| tradeId      | string | true     | none       | Trade ID                    |
| authCode     | string | true     | none       | Authorization code          |