---
title: "Get normalized swap status"
method: GET
path: "/api/v1/status"
tags: ["Swap"]
---

# Get normalized swap status

`GET /api/v1/status`

## Request

- Base URL: `https://app.ravn.exchange`
- URL: `https://app.ravn.exchange/api/v1/status`
- Auth: one of:
  - API key in header `x-api-key`
  - none

## Query parameters

- `quoteToken` string, required
- `ref` string, required
- `txHash` string

## Response `200`

Status resolved

- object
  - `data` StatusDTO
    - `status` 'pending' | 'processing' | 'expired' | 'success' | 'refunded' | 'failed' | 'not_found' | 'unknown', required
    - `venue` string, required
    - `venueStatus` unknown
    - `tracking` 'unavailable'
    - `deliveredAmount` string, nullable: Actual delivered output in the output token's base units, when the venue exposes it. Only populated once `status` is terminal.
    - `txHash` string, nullable: The destination-chain tx that paid the user out, when the venue names one. Only populated once `status` is terminal (success/refunded/failed) — e.g. THORChain can report a real outbound tx while still "processing" and before it's known whether that tx is the payout or a refund, so it's withheld until terminal to avoid a caller treating an in-flight tx as the payout landing.
  - `meta` Meta
    - `requestId` string, required
    - `version` string, required

## Other responses

- `400`: Invalid request or malformed quoteToken
- `401`: x-api-key present but invalid

---

[API](https://skmtc.dev/ravn/apis/ravn-swap-api.md) · [All operations](https://skmtc.dev/ravn/apis/ravn-swap-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ravn/apis/ravn-swap-api/revisions/f1c5a0c63392?raw)