> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravn.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /status

> Normalized swap status.

Poll the progress of a swap. `ref` is the `statusRef` returned by
[`/execute`](/api-reference/execute) (DEPOSIT) or [`/submit-signature`](/api-reference/submit-signature)
(SIGNATURE).

## Request

<ParamField query="quoteToken" type="string" required>The opaque token from `/quote`.</ParamField>
<ParamField query="ref" type="string" required>The `statusRef` for this swap.</ParamField>

```bash theme={null}
curl -s "https://app.ravn.exchange/api/v1/status?quoteToken=<token>&ref=<statusRef>"
```

## Response

<ResponseField name="status" type="string">Normalized lifecycle state.</ResponseField>
<ResponseField name="venue" type="string">The venue handling the swap.</ResponseField>

| `status`     | Meaning                                 |
| ------------ | --------------------------------------- |
| `pending`    | Awaiting the deposit / not yet observed |
| `processing` | Funds received, solver filling          |
| `success`    | Delivered                               |
| `refunded`   | Returned to sender                      |
| `failed`     | Terminal failure                        |
| `not_found`  | `ref` unknown to the venue              |
| `unknown`    | Venue not yet wired for tracking        |

```json theme={null}
{ "data": { "status": "processing", "venue": "near_intents" } }
```

<Note>
  Status tracking is live for NEAR Intents today; more venues are being wired. The response
  shape is stable — venues not yet tracked return `status: "unknown"`.
</Note>