> ## 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.

# Get an x402 transfer by ID

> Retrieves a single x402 transfer by its unique identifier.



## OpenAPI

````yaml openapi/gateway-nanopayments.yaml get /v1/x402/transfers/{id}
openapi: 3.0.3
info:
  title: Gateway Nanopayments
  version: 1.0.0
  description: >
    Gateway Nanopayments settles gasless USDC payments for the x402 protocol
    using Circle Gateway's batched settlement infrastructure. Sellers verify
    buyer authorizations and settle net positions in bulk onchain.
servers:
  - url: https://gateway-api-testnet.circle.com
  - url: https://gateway-api.circle.com
security: []
tags:
  - name: Settlement
    description: >-
      Verify buyer-signed x402 authorizations and submit them for batched
      settlement through Circle Gateway.
  - name: Batched transfers
    description: >-
      Query the batched USDC transfers Gateway settles from accepted x402
      authorizations.
  - name: Supported payment kinds
    description: Discover the x402 payment schemes and networks this facilitator supports.
paths:
  /v1/x402/transfers/{id}:
    get:
      tags:
        - Batched transfers
      summary: Get an x402 transfer by ID
      description: Retrieves a single x402 transfer by its unique identifier.
      operationId: GetX402TransferById
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: Transfer UUID.
      responses:
        '200':
          description: The transfer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402TransferResponse'
        '404':
          description: Transfer not found
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.
        nonce:
          type: string
          description: EIP-3009 nonce.
        txHash:
          type: string
          nullable: true
          description: >-
            Batch-level settlement transaction hash, shared by all transfers in
            the same batch. Remains null until included in a batch with a
            settlement transaction hash.
        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
        - nonce
        - txHash
        - createdAt
        - updatedAt

````