---
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 that owns the swap: a business ID prefixed `biz_`, or the user ID for a personal account.
  - `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.
  - `user_id` string, nullable, required — User whose personal account owns the swap, prefixed `user_`. Null for a business account.

## Other responses

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

## Changes

> 74 revisions in range; 1 not diffed.

- **2026-09-27** `78e1ed7366cd` — 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-09-26** `73dd0533cd81` — 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-09-25** `86b97292852d` — 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-09-25** `c1dceb26e505` — 4 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`
  - added the new optional `header` request parameter `Api-Version-Date` to all path's operations
  - added the required property `user_id` to the response with the `200` status
- **2026-09-24** `7fcefabddb0a` — 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`

[Full 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.dev/whop/apis/whop-api/revisions/78e1ed7366cd?raw)