---
title: "List swaps"
method: GET
path: "/api/swap"
tags: ["Swap"]
---

# List swaps

`GET /api/swap`

Returns a paginated list of swaps for the authenticated merchant, sorted by `createdAt` descending.

## Query parameters

- `page` number
- `limit` number

## Response `200`

- object
  - `data` ApiSwapDto[]
    - `id` string, required
    - `userId` string, required
    - `fromCurrency` 'USDC' | 'EURC', required
    - `toCurrency` 'USDC' | 'EURC', required
    - `amount` number, required — Source amount in cents (smallest unit of fromCurrency)
    - `status` 'INITIATED' | 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'RETURNED' | 'REFUNDED', required — Merchant-facing status. Internal states (`DEPOSIT_COMPLETED`, `AWAITING_LIQUIDATION`) are collapsed to `PENDING` before being returned, so they will never appear on the wire.
    - `context` 'bridge' | 'privy', nullable — Pipeline a swap follows: `bridge` (3 steps) or `privy` (2 steps).
    - `toAmountInCents` number, nullable — Final destination amount in cents (smallest unit of toCurrency). `null` until the swap settles.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `meta` object
    - `total` number
    - `lastPage` number
    - `currentPage` number
    - `perPage` number
    - `prev` number
    - `next` number

## Other responses

- `401` — Unauthorized - Invalid API key

---

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