---
title: "Retrieve a swap"
method: GET
path: "/v2/wallets/swaps/{swapId}"
tags: ["Token Swap"]
---

# Retrieve a swap

`GET /v2/wallets/swaps/{swapId}`

Retrieve details of a specific swap by its ID.

## Path parameters

- `swapId` string, required

## Response `200`

Success

- 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'

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