> ## Documentation Index
> Fetch the complete documentation index at: https://docs-payment-merchant.keysecure.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account Transfer Flow List

Queries the account transfer flow list (**credit extension mode**).

## Request Headers

<ParamField header="Api-Key" type="string" required placeholder="your_api_key">
  apiKey (merchant credential, bound to IP whitelist)
</ParamField>

<ParamField header="Timestamp" type="string" required>
  Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
</ParamField>

<ParamField header="Access-Token" type="string" required placeholder="your_access_token">
  Login token (required for all interfaces except Get Token).
</ParamField>

<ParamField header="Content-Type" type="string" default="application/json">
  Fixed to `application/json`
</ParamField>

<ParamField header="Timezone" type="string" default="UTC+8">
  Timezone, affects the day boundary calculation for `start_time` / `end_time`. Defaults to UTC+8.
</ParamField>

## Request Body

<ParamField body="cardholder_no" type="string">
  Cardholder order number.
</ParamField>

<ParamField body="transfer_no" type="string">
  Transfer order number.
</ParamField>

<ParamField body="transfer_unique_no" type="string">
  Merchant-side transfer order number.
</ParamField>

<ParamField body="start_time" type="string" required>
  Start time (`yyyy-MM-dd` or `yyyy-MM-dd HH:mm:ss`).
</ParamField>

<ParamField body="end_time" type="string" required>
  End time (same format as above; interval ≤ 90 days).
</ParamField>

<ParamField body="page" type="number" default="0">
  Query page number. Defaults to `0`.
</ParamField>

<ParamField body="size" type="number" default="10">
  Number of records per page. Defaults to `10` (max 100).
</ParamField>

## Response Parameters

<ResponseField name="code" type="number">
  Response status code. `0` indicates success.
</ResponseField>

<ResponseField name="msg" type="string">
  Response message.
</ResponseField>

<ResponseField name="data" type="object">
  Response data.

  <Expandable title="data">
    <ResponseField name="list" type="object[]">
      Transfer flow list.

      <Expandable title="list">
        <ResponseField name="cardholder_no" type="string">Cardholder order number</ResponseField>
        <ResponseField name="transfer_no" type="string">Order number</ResponseField>
        <ResponseField name="transfer_unique_no" type="string">Merchant-side unique order number</ResponseField>
        <ResponseField name="symbol" type="string">Currency</ResponseField>
        <ResponseField name="symbol_chain" type="string">Currency main chain</ResponseField>
        <ResponseField name="before_balance" type="string">Balance before transfer</ResponseField>
        <ResponseField name="after_balance" type="string">Balance after transfer</ResponseField>
        <ResponseField name="balance" type="string">Transfer amount</ResponseField>
        <ResponseField name="status" type="string">Transfer status, see \[Constants] Common Status</ResponseField>
        <ResponseField name="time" type="number">Transfer time (Unix milliseconds)</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --request POST \
    --url https://sandbox-openplatform.keysecure.io/open-api/v1/account/transfer/list \
    --header 'Content-Type: application/json' \
    --header 'Api-Key: your_api_key' \
    --header 'Timestamp: 1716307200000' \
    --header 'Access-Token: your_access_token' \
    --header 'Timezone: UTC+8' \
    --data '{
      "cardholder_no": "",
      "transfer_no": "",
      "transfer_unique_no": "",
      "start_time": "2026-01-01",
      "end_time": "2026-03-31",
      "page": 0,
      "size": 10
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "code": 0,
    "msg": "Success",
    "data": {
      "list": [{
        "cardholder_no": "",
        "transfer_no": "",
        "transfer_unique_no": "",
        "symbol": "TUSDT",
        "symbol_chain": "",
        "before_balance": "",
        "after_balance": "",
        "balance": "",
        "status": "Success",
        "time": 1716307200000
      }]
    }
  }
  ```
</ResponseExample>
