---
title: "Retrieve Swap"
method: GET
path: "/swaps/{id}"
tags: ["Swaps"]
---

# Retrieve Swap

`GET /swaps/{id}`

Retrieves a single swap and its status.

## Path parameters

- `id` string, required

## Response `200`

swap status retrieved

- object
  - `account_id` string, required — Account ID that owns the wallet used for the swap.
  - `error` string, nullable — Latest error returned for a failed swap.
  - `id` string, required — Swap ID.
  - `object` 'swap', required
  - `status` 'queued' | 'working' | 'complete' | 'failed', required — Current swap status. `complete` and `failed` are terminal.
  - `tx_hashes` string[], required — On-chain transaction hashes produced by the swap.

## Other responses

- `400` — Invalid Parameters
- `403` — Forbidden
- `404` — Resource not found

## Changes

- **2026-08-04** `ca841fbd6786` — 2 info
  - the security scope `crypto_wallet:swap` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-07-31** `099fdc3be422` — 4 warning
  - added the new `complete` enum value to the `status` response property for the response status `200`
  - added the new `failed` enum value to the `status` response property for the response status `200`
  - added the new `queued` enum value to the `status` response property for the response status `200`
  - added the new `working` enum value to the `status` response property for the response status `200`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/swaps/:id/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/ca841fbd6786/schema)