# Transfer Batch Query

> Query transfer records in batches with pagination.

```yaml
openapi: 3.1.0
info:
  title: Transfer Batch Query
  version: 1.0.0
  description: Query transfer records in batches with pagination.
paths:
  /api/v1/txn/queryList:
    post:
      summary: Transfer Batch Query
      description: Query transfer records in batches with pagination.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. Retrieve it from the merchant
                    portal or onboarding material after your sandbox or
                    production account is created.
                requestId:
                  type: string
                  description: Optional merchant request ID filter.
                payoutId:
                  type: string
                  description: Optional Onerway payout ID filter.
                payoutStatus:
                  type: string
                  description: Optional transfer-status filter.
                payoutStartTime:
                  type: string
                  description: Optional start time of the payout window.
                payoutEndTime:
                  type: string
                  description: Optional end time of the payout window.
                createTimeStartTime:
                  type: string
                  description: Start time of the create-time window.
                createTimeEndTime:
                  type: string
                  description: End time of the create-time window.
                payoutMethod:
                  type: string
                  description: Optional payout-method filter.
                size:
                  type: integer
                  description: Page size.
                current:
                  type: integer
                  description: Current page number.
                sign:
                  type: string
                  description: Request signature string. Generate it according to the Transfer
                    request-signing rules with your merchant private key.
              required:
                - merchantNo
                - createTimeStartTime
                - createTimeEndTime
                - size
                - current
                - sign
            examples:
              query-transfers:
                summary: Query transfers in batch
                value:
                  createTimeEndTime: 2025-09-10 12:00:00
                  createTimeStartTime: 2025-09-01 12:00:00
                  current: 1
                  merchantNo: "801129"
                  sign: "{{SIGN}}"
                  size: 10
              query-processing-transfers:
                summary: Query processing transfers within a time window
                value:
                  createTimeEndTime: 2025-09-02 00:00:00
                  createTimeStartTime: 2025-09-01 00:00:00
                  current: 1
                  merchantNo: "801129"
                  payoutStatus: P
                  sign: "{{SIGN}}"
                  size: 20
      responses:
        "200":
          description: Paged transfer result
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: Response code returned by Onerway.
                  respMsg:
                    type:
                      - string
                      - "null"
                    description: Response message returned by Onerway.
                    x-onerway-value:
                      nullable: true
                      when:
                        en: No response message is returned.
                        zh: 未返回响应信息时为 `null`。
                  data:
                    type: object
                    properties:
                      records:
                        type: array
                        description: Transfer record list.
                        items:
                          type: object
                          properties:
                            payoutId:
                              type: string
                              description: Onerway payout ID.
                            requestId:
                              type: string
                              description: Merchant request ID.
                            payoutStatus:
                              type: string
                              description: Transfer status.
                            payoutMethod:
                              type: string
                              description: Payout method.
                      total:
                        type: integer
                        description: Total record count.
                      size:
                        type: integer
                        description: Page size.
                      current:
                        type: integer
                        description: Current page number.
                    description: Paged transfer query result.
              examples:
                transfer-page:
                  summary: Paged transfer result
                  value:
                    respCode: "20000"
                    respMsg: null
                    data:
                      records:
                        - payoutId: "1965301538608513024"
                          requestId: DM202509090001
                          payoutStatus: S
                          payoutMethod: E_WALLET
                      total: 1
                      size: 10
                      current: 1
                transfer-page-mixed-status:
                  summary: Paged transfer result with mixed statuses
                  value:
                    respCode: "20000"
                    respMsg: null
                    data:
                      records:
                        - payoutId: "1965301538608513024"
                          requestId: DM202509090001
                          payoutStatus: S
                          payoutMethod: E_WALLET
                        - payoutId: "1965301538608513025"
                          requestId: DM202509090002
                          payoutStatus: P
                          payoutMethod: BANK_TRANSFER
                        - payoutId: "1965301538608513026"
                          requestId: DM202509090003
                          payoutStatus: F
                          payoutMethod: BANK_TRANSFER
                      total: 3
                      size: 20
                      current: 1
```