# Get Topup History

This interface is used to get the transaction list of a card in a specific date range. Date range is up to three months.

* **Path: /api/v1/card/getTopupTransactionList**
* **Method: POST**
* **Content-Type**

  application/json
* **Headers**

| Key           | Type   | Required | Comments             |
| ------------- | ------ | -------- | -------------------- |
| authorization | string | YES      | Authorization Header |

* **Body**

| Key             | Type   | Required | Comments                                                                                                                 |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| api\_key        | string | YES      | api key                                                                                                                  |
| request\_id     | string | YES      | Unique id; the shortest is 20 characters, the longest is 64 characters                                                   |
| timestamp       | string | YES      | 13-digit; Valid for plus or minus 30 seconds                                                                             |
| username        | string | YES      | Unique username of the account.                                                                                          |
| kit\_number     | string | YES      | Show on card                                                                                                             |
| top\_up\_method | number | NO       | topup method；3Blockchain Direct、5FEB API topup                                                                           |
| start\_date     | string | YES      | This field is the start date for filtering transactions data.Format: YYYY-MM-DD.                                         |
| end\_date       | string | YES      | This field is the end date for filtering transactions data.Cannot be 3 months later than start\_date.Format: YYYY-MM-DD. |
| sign            | string | YES      | sign: MD5(api\_key+username+timestamp+secret+request\_id)lowercase hex                                                   |

* **Example**

  ```js
  {
    api_key: 'ac97c403062e94a094131aa332df6458',
    request_id: '48d66a3ad67b4a3a8c4914a8b8927106',
    timestamp: '1722237748943',
    username: 'frfrfr',
    kit_number: '2000001785317853',
    top_up_method: 3,
    start_date: '2024-05-29',
    end_date: '2024-07-29',
    sign: '92526c65a3780d5d95afd6f278e52e72'
  }
  ```

  **signature example**:MD5(ac97c403062e94a094131aa332df6458frfrfr1722237748943a446b6660552582e08b043b84634e1fe48d66a3ad67b4a3a8c4914a8b8927106)
* **Response**

| Key  | Type   | Comments                             |
| ---- | ------ | ------------------------------------ |
| code | number | Response code                        |
| msg  | string | Response message                     |
| data | object | [details](#getTopupTransactionList1) |

**details**

| Key  | Type                                                | Comments         |
| ---- | --------------------------------------------------- | ---------------- |
| list | array\[[object details](#getTopupTransactionList2)] | Transaction list |

**object details**

| Key               | Type   | Comments                                       |
| ----------------- | ------ | ---------------------------------------------- |
| amount            | string | topup amount                                   |
| status            | number | topup receive status. 1 success； 2 fail        |
| token\_type       | string | token type USDT、USDC                           |
| card\_status      | number | topup card status 1 pending 2success 3fail     |
| top\_up\_method   | number | topup method；3Blockchain Direct、5FEB API topup |
| token\_amount     | string | token amount                                   |
| time              | number | FEB system entry time                          |
| transaction\_id   | string | Unique on-chain transaction id                 |
| transaction\_hash | string | Unique on-chain transaction hash               |

* **Example**

  ```js
  {
    "code": 10200,
    "msg": "ok",
    "data": {
      "list": [{
        "amount": "145.63",
        "status": 1,
        "token_type": "USDT",
        "card_status": 2,
        "top_up_method": 3,
        "token_amount": "150",
        "time": 1718425978468,
        "transaction_id": "2034497cffde4a28b27b971ef4895d60",
        "transaction_hash": "c9c900874643d79124f9b6216b033b4a20c680a0b363d9c17dc659bc0f8ddefe"
      },
      {
        "amount": "6.79",
        "status": 1,
        "token_type": "USDT",
        "card_status": 2,
        "top_up_method": 3,
        "token_amount": "7",
        "time": 1718426531736,
        "transaction_id": "a9eb7211e3404fa99f40902fbd9d5255",
        "transaction_hash": "14f5c987418d80df50047934fd7b8c7cb7893c907ff105842f2323ad911f4e6b"
      }]
    }
  }
  ```
