> ## Documentation Index
> Fetch the complete documentation index at: https://developers.circle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search x402 transfers

> Returns a paginated list of x402 transfers matching the given filters.
Supports cursor-based pagination via pageAfter / pageBefore.




## OpenAPI

````yaml openapi/gateway.yaml get /v1/x402/transfers
openapi: 3.0.3
info:
  title: Circle Gateway
  version: 1.0.0
  description: >
    Circle Gateway allows you to create a chain-abstracted USDC balance and
    transfer it instantly to any supported destination chain.
servers:
  - url: https://gateway-api-testnet.circle.com
  - url: https://gateway-api.circle.com
security: []
tags:
  - name: Gateway
    description: >-
      Endpoints for getting a unified USDC balance and creating attestations for
      transfer
  - name: Gateway Batch
    description: Endpoints for batch processing of EIP-3009 authorizations
  - name: Gateway x402
    description: Endpoints for x402 payment protocol integration
  - name: Webhook Subscriptions
    description: Manage webhook subscriptions for Gateway event notifications.
paths:
  /v1/x402/transfers:
    get:
      tags:
        - Gateway x402
      summary: Search x402 transfers
      description: |
        Returns a paginated list of x402 transfers matching the given filters.
        Supports cursor-based pagination via pageAfter / pageBefore.
      operationId: SearchX402Transfers
      parameters:
        - in: query
          name: from
          schema:
            type: string
          description: Filter by sender address.
        - in: query
          name: to
          schema:
            type: string
          description: Filter by recipient address.
        - in: query
          name: network
          schema:
            type: string
          description: Filter by CAIP-2 network identifier (e.g., eip155:11155111).
        - in: query
          name: status
          schema:
            type: string
            enum:
              - received
              - batched
              - confirmed
              - completed
              - failed
          description: Filter by transfer status.
        - in: query
          name: token
          schema:
            type: string
            enum:
              - USDC
          description: Filter by token type.
        - in: query
          name: startDate
          schema:
            type: string
            format: date-time
          description: Filter transfers created on or after this date.
        - in: query
          name: endDate
          schema:
            type: string
            format: date-time
          description: Filter transfers created on or before this date.
        - in: query
          name: pageSize
          schema:
            type: integer
            minimum: 1
          description: Number of results per page.
        - in: query
          name: pageAfter
          schema:
            type: string
          description: Cursor for the next page of results.
        - in: query
          name: pageBefore
          schema:
            type: string
          description: Cursor for the previous page of results.
      responses:
        '200':
          description: Paginated list of transfers
          content:
            application/json:
              schema:
                type: object
                properties:
                  transfers:
                    type: array
                    items:
                      $ref: '#/components/schemas/X402TransferResponse'
        '400':
          description: Invalid request parameters
components:
  schemas:
    X402TransferResponse:
      type: object
      description: Response containing details of an x402 transfer.
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the transfer.
        status:
          type: string
          enum:
            - received
            - batched
            - confirmed
            - completed
            - failed
          description: |
            Current status of the x402 transfer:

            - `received`: Transfer has been submitted and accepted
            - `batched`: Transfer has been included in a batch for processing
            - `confirmed`: Transfer has been confirmed onchain
            - `completed`: Transfer is fully complete
            - `failed`: Transfer has failed
        token:
          type: string
          description: Token symbol (e.g., USDC).
          example: USDC
        sendingNetwork:
          type: string
          description: CAIP-2 network identifier for the sending chain.
          example: eip155:11155111
        recipientNetwork:
          type: string
          description: CAIP-2 network identifier for the recipient chain.
          example: eip155:11155111
        fromAddress:
          type: string
          description: Sender address.
        toAddress:
          type: string
          description: Recipient address.
        amount:
          type: string
          description: Transfer amount in atomic units.
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the transfer was created.
        updatedAt:
          type: string
          format: date-time
          description: Timestamp when the transfer was last updated.
      required:
        - id
        - status
        - token
        - sendingNetwork
        - recipientNetwork
        - fromAddress
        - toAddress
        - amount
        - createdAt
        - updatedAt

````