---
title: "Retrieves history of swap operations"
method: GET
path: "/superuser/swap/history"
tags: ["Swap Operations"]
---

# Retrieves history of swap operations

`GET /superuser/swap/history`

Get user's token swaps

## Query parameters

- `page` integer
- `pageSize` integer
- `id` string
- `taxId` string
- `externalId` string

## Response `200`

Transactions retrieved

- SwapHistoryOutput
  - `swapLogs` SwapOpLog[], required
    - `id` string, uuid
    - `chain` 'Polygon' | 'Ethereum' | 'Moonbeam' | 'Tron' | 'XRP' | 'Chiliz' — Not all chains might be available for every operation
    - `walletAddress` string
    - `receiverAddress` string
    - `referenceLabel` string
    - `externalId` string — External id you can input to help later conciliation. Up to 40 alphanumeric characters.
    - `brlaAmount` integer
    - `usdAmount` integer
    - `usdToBrla` boolean
    - `coin` 'BRLA' | 'USDC' | 'USDT' | 'ETH' | 'GLMR' | 'MATIC' | 'CHZ' — Not all coins might be available for every operation
    - `userDocument` string
    - `basePrice` string
    - `baseFee` string
    - `smartContractOps` SmartcontractOperationLog[]
      - `id` string, uuid
      - `operationName` string
      - `posted` boolean
      - `tx` string
      - `notPostedReason` string
      - `createdAt` string, date-time
      - `isRetry` boolean
      - `feedback` SmartcontractOperationFeedbackLog
        - `id` string, uuid
        - `success` boolean
        - `errorMsg` string
        - `createdAt` string, date-time
    - `permit` PermitData
      - `deadline` integer — UNIX milliseconds timestamp
      - `nonce` integer
      - `r` string — Hex encoded (e.g. 0x...)
      - `s` string — Hex encoded (e.g. 0x...)
      - `v` integer
    - `createdAt` string, date-time

## Other responses

- `400` — Input could not be validated
- `401` — Authorization failure
- `429` — Rate limited
- `500` — Error internal to the server which probably shouldn't have happened, try again later

---

[API](https://skmtc.net/brla/apis/brla-superuser-api.md) · [All operations](https://skmtc.net/brla/apis/brla-superuser-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brla/brla-superuser-api/versions/236b95ba5c14/schema)