---
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` 'PENDING' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `source` WalletSwapSourceObject
        - `currency` string
        - `amount` number
        - `chain` string
        - `userId` string, uuid
      - `destination` WalletSwapDestinationObject
        - `currency` string
        - `userId` string, uuid
        - `externalWalletId` string, uuid, nullable
        - `amount` number, nullable
        - `chain` string
        - `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
      - `billingInformation` WalletSwapBillingInformationObject
        - `fees` WalletSwapFeeObject[]
          - `id` string, uuid
          - `amount` number
          - `currency` string
          - `type` 'EXCHANGE_FEE' | 'GAS_FEE'
          - `timing` 'ON_INVOICE' | 'ON_TRANSACTION'
  - `nextCursor` string, date-time

## Other responses

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

---

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