---
title: "List top-up records"
method: POST
path: "/open-api/v3/scan2pay/funding/top-ups/search"
tags: ["Funding"]
---

# List top-up records

`POST /open-api/v3/scan2pay/funding/top-ups/search`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/scan2pay/funding/top-ups/search`
- Auth: API key in header `x-access-token`

Retrieves top-up records for the API client account, with optional
pagination and filtering criteria.

For the request structure, see the
[Top-Up Search Request Resource](https://developer.interlace.money/docs/scan-to-pay#top-up-search-request-resource).
For each item in the paginated response, see the
[Top-Up Record Resource](https://developer.interlace.money/docs/scan-to-pay#top-up-record-resource).

## Request body

- PageTopUpsRecordReqDTO
  - `page` integer: Page number
  - `limit` integer: Number of records per page
  - `type` 'CHARGE' | 'REFUND': Top-up record type
  - `amountCurrency` 'USDT' | 'USDC': Asset symbol
  - `status` 'SUCCESS' | 'PENDING' | 'FAILED' | 'FREEZE' | 'REFUNDED': Top-up status
  - `chain` 'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'ETH' | 'MATIC' | 'OP' | 'TRX' | 'TON' | 'SOL': Blockchain network
  - `transactionHash` string: Transaction hash
  - `minGmtCreate` string: Numeric string representing the minimum Unix timestamp in milliseconds since epoch
  - `maxGmtCreate` string: Numeric string representing the maximum Unix timestamp in milliseconds since epoch
  - `minGmtModified` string: Numeric string representing the minimum last-updated Unix timestamp in milliseconds since epoch
  - `maxGmtModified` string: Numeric string representing the maximum last-updated Unix timestamp in milliseconds since epoch

## Response `200`

Successful operation

- ApiPageResultPageTopUpsRecordRespDTO: Standard API response wrapper
  - `code` string: Business code, 000000 means success
  - `message` string: Message description
  - `data` DataWrapperPageTopUpsRecordRespDTO: Data wrapper for list results
    - `total` string: Total number of items
    - `list` PageTopUpsRecordRespDTO[]: List of data items
      - `id` string: Numeric string representing the top-up record identifier
      - `type` 'CHARGE' | 'REFUND': Top-up record type
      - `amountCurrency` 'USDT' | 'USDC': Asset symbol
      - `status` 'SUCCESS' | 'PENDING' | 'FAILED' | 'FREEZE' | 'REFUNDED': Top-up status
      - `chain` 'ARB' | 'AVAX' | 'BASE' | 'BNB' | 'ETH' | 'MATIC' | 'OP' | 'TRX' | 'TON' | 'SOL': Blockchain network
      - `amount` number: Top-up amount
      - `transactionHash` string: Transaction hash
      - `createTime` string: Numeric string representing the creation Unix timestamp in milliseconds since epoch
      - `updateTime` string: Numeric string representing the last-updated Unix timestamp in milliseconds since epoch

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/interlace/apis/scan-to-pay.md) - [All operations](https://skmtc.dev/interlace/apis/scan-to-pay/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/scan-to-pay/revisions/81f4c583068b?raw)