Overview

Query the change history of your card account balance.

Balance Change Records

Resquest

cURL -X POST /card-api/v1/balance/change/records
-H 'Content-Type: application/json'
-H 'Authorization: {token}'
-d '{
      "cursor": "",
      "bill_currency_list": [
        "USD"
      ],
      "fund_type_list": [
        "20"
      ],
      "from_changed_at": "2025-06-06T10:45:40+08:00",
      "program_value_list": [
        "6"
      ],
      "limit": 10,
      "to_changed_at": "2025-06-29T10:45:40+08:00",
      "ascending": false,
      "moving_account_currency_list": [
        "USD"
      ]
   }'

Parameter	Description	Type
limit	Number of records to query
from_changed_at	Start time of the balance change
to_changed_at	End time of the balance change
bill_currency_list	Billing currency list	ARRAY
fund_type_list	Fund type	20 : Card limit creation 21 : Monthly bill 22 : Settlement of monthly bill 23 : Release limit 24 : Forex sell 25 : Forex buy 28 : Card payout
program_value_list	Account card type list	ARRAY
moving_account_currency_list	Currency of the balance change	ARRAY

Responses

{
    "code": "200",
    "msg": "Success",
    "trace_id": "686bc53dbdbc4d05ab616632cd63c0ef",
    "data": {
        "data": [
            {
                "program_value": 6,
                "moving_account_Time": "2025-06-10T15:33:27+08:00",
                "moving_account_type": 1,
                "fund_type": 20,
                "batch_no": "102902",
                "bill_amount": 100,
                "bill_currency": "USD",
                "moving_account_amount": 100,
                "moving_account_currency": "USD",
                "card_limit_currency": "USD",
                "card_limit_amount": 12555.4,
                "card_exchange_rate": 1.0000000000,
                "card_exchange_time": null
            },
            {
                "program_value": 6,
                "moving_account_Time": "2025-06-10T14:50:49+08:00",
                "moving_account_type": 1,
                "fund_type": 20,
                "batch_no": "102901",
                "bill_amount": 100,
                "bill_currency": "USD",
                "moving_account_amount": 100,
                "moving_account_currency": "USD",
                "card_limit_currency": "USD",
                "card_limit_amount": 12455.4,
                "card_exchange_rate": 1.0000000000,
                "card_exchange_time": null
            },
        "next_cursor": "3620",
        "has_more": true
    }
}

Fields	Description
has_more	Whether there are more pages
program_value_list	Program value
moving_account_Time	Time of balance movement
moving_account_type	Type of movement 1: credit 2: debit
fund_type	Fund type
batch_no	Batch number
bill_amount	Billing amount
bill_currency	Billing currency
moving_account_amount	Amount of balance change
moving_account_currency	Currency of balance change
card_limit_currency	Card limit currency
card_limit_amount	Card limit amount
card_exchange_rate	Exchange rate used for the card
card_exchange_time	Time of currency conversion