---
title: "List all swaps"
method: GET
path: "/v2/wallets/swaps"
tags: ["Token Swap"]
---

# List all swaps

`GET /v2/wallets/swaps`

Returns a list of swaps associated with a user under your organization. The swaps are returned sorted by creation date, with the most recent swaps appearing first.

## Query parameters

- `userId` string
- `limit` string
- `createdBefore` string, date
- `createdAfter` string, date

## Response `200`

Success

- WalletSwapAllRecordsObject
  - `count` integer
  - `data` WalletSwapObject[]
    - `transferType` string
    - `transferDetails` WalletSwapDetailsObject
      - `id` string, uuid
      - `requestId` string, uuid
      - `status` 'OPEN_QUOTE' | 'CREATED' | 'PENDING' | 'COMPLETED' | 'QUOTE_FAILED' | 'FAILED'
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `source` WalletSwapSourceObject
        - `currency` 'usdc' | 'usdt' | 'usdg' | 'pyusd' | 'pyusd0'
        - `amount` number
        - `chain` 'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'FLOW_EVM'
        - `userId` string, uuid
      - `destination` WalletSwapDestinationObject
        - `currency` 'usdc' | 'usdt' | 'usdg' | 'pyusd' | 'pyusd0'
        - `userId` string, uuid
        - `externalWalletId` string, uuid, nullable
        - `amount` number, nullable
        - `chain` 'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'FLOW_EVM'
        - `walletAddress` string
      - `error` string, nullable
      - `errorDetails` string, nullable
      - `quoteInformation` WalletSwapQuoteInformationObject
        - `sendGross` WalletSwapAmountObject
          - `amount` string
          - `currency` string
        - `sendNet` WalletSwapAmountObject
          - `amount` string
          - `currency` string
        - `receiveGross` WalletSwapAmountObject
          - `amount` string
          - `currency` string
        - `receiveNet` WalletSwapAmountObject
          - `amount` string
          - `currency` string
        - `rate` string
        - `expiresAt` string, date-time
  - `nextCursor` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/hifi/apis/hifi-api.md) · [All operations](https://skmtc.net/hifi/apis/hifi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hifi/hifi-api/revisions/15a39c342fd1/schema)