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

# Get Conversion

> GET /v2/rfq/{id} — retrieve the current state and attributes of a conversion.

## Path parameters

| Parameter | Description                                                                                    |
| --------- | ---------------------------------------------------------------------------------------------- |
| `id`      | The `rfq_id` returned by [Create Conversion](/noxpay-docs-v2/api-reference/conversions/create) |

## Response `200 OK`

A conversion moves through three internal components in sequence — `quote_otc` → `rfq_swap` → `settlement_rfq`. The `component` field tells you which stage the conversion is in, and `state` tells you its status within that stage.

### Conversion states

**`quote_otc`** — the quote itself, before and up to acceptance.

| State        | Meaning                                                                           |
| ------------ | --------------------------------------------------------------------------------- |
| `QUOTE`      | Quote is active; awaiting your acceptance                                         |
| `DONE`       | Accepted — balance validated, trade locked, delivery scheduled                    |
| `EXPIRED`    | Rate expired; a fresh rate was generated automatically — review before accepting  |
| `DEPRECATED` | Renewal window closed; create a new conversion                                    |
| `ERROR`      | Insufficient balance, limit exceeded, invalid currency, or another business error |

**`rfq_swap`** — internal ledger entries for the trade (transitions immediately after acceptance; not user-actionable).

| State     | Meaning                                                                         |
| --------- | ------------------------------------------------------------------------------- |
| `INITIAL` | Recording ledger entries for the swap (transient)                               |
| `DONE`    | Ledger entries recorded; converted amount held as a receivable pending delivery |
| `ERROR`   | Failed to record — Noxpay operations notified                                   |

**`settlement_rfq`** — delivery of the converted funds.

| State      | Meaning                                                                                |
| ---------- | -------------------------------------------------------------------------------------- |
| `AWAITING` | Waiting for the settlement window (D0 or D1)                                           |
| `DONE`     | Delivery complete; funds moved to your available balance                               |
| `ERROR`    | Delivery failed; funds remain safely held as a receivable — Noxpay operations notified |

### Attributes

| Field               | Type   | Description                                        |
| ------------------- | ------ | -------------------------------------------------- |
| `from_currency`     | string | Source currency                                    |
| `to_currency`       | string | Destination currency                               |
| `quote_pair`        | string | Quote pair (e.g. `USDT_BRL`)                       |
| `from_amount_d0`    | float  | D0 amount to send                                  |
| `to_amount_d0`      | float  | D0 amount to receive                               |
| `rate_d0`           | float  | D0 rate                                            |
| `from_amount_d1`    | float  | D1 amount to send                                  |
| `to_amount_d1`      | float  | D1 amount to receive                               |
| `rate_d1`           | float  | D1 rate                                            |
| `settlement_eta_d0` | string | D0 settlement ETA (RFC 3339)                       |
| `settlement_eta_d1` | string | D1 settlement ETA (RFC 3339)                       |
| `expires_at`        | string | Current quote's expiration (RFC 3339)              |
| `renewable_up_to`   | string | Last moment the quote can be accepted (RFC 3339)   |
| `settlement_day`    | string | `d0` or `d1` — populated after accept              |
| `amount_from`       | float  | Confirmed amount sent — populated after accept     |
| `amount_to`         | float  | Confirmed amount received — populated after accept |
| `rate`              | float  | Confirmed rate — populated after accept            |
| `settlement_eta`    | string | Confirmed settlement ETA — populated after accept  |
| `wallet_id`         | string | Destination wallet, if applicable                  |
| `pix_key`           | string | Destination Pix key, if applicable                 |
| `error_detail`      | string | Client-facing error message, if any                |
| `webhook`           | string | Configured webhook URL                             |

**`404`** — conversion not found or does not belong to your account.

<RequestExample>
  ```bash theme={null}
  curl https://checkout.noxpay.io/v2/rfq/NOXabc123 \
    -H "api-key: <key>"
  ```

  ```python theme={null}
  import requests

  response = requests.get(
      "https://checkout.noxpay.io/v2/rfq/NOXabc123",
      headers={"api-key": "<key>"},
  )
  print(response.json())
  ```

  ```javascript theme={null}
  const response = await fetch(
    "https://checkout.noxpay.io/v2/rfq/NOXabc123",
    { headers: { "api-key": "<key>" } }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "rfq_id": "NOXabc123",
    "component": "settlement_rfq",
    "state": "AWAITING",
    "created_at": "2026-07-01T12:00:00Z",
    "updated_at": "2026-07-01T12:00:31Z",
    "attributes": {
      "from_currency": "USDT",
      "to_currency": "BRL",
      "quote_pair": "USDT_BRL",
      "from_amount_d0": 1000.0,
      "to_amount_d0": 5050.0,
      "rate_d0": 5.050,
      "from_amount_d1": 1000.0,
      "to_amount_d1": 5060.0,
      "rate_d1": 5.060,
      "settlement_eta_d0": "2026-07-01T19:00:00Z",
      "settlement_eta_d1": "2026-07-02T18:00:00Z",
      "expires_at": "2026-07-01T12:00:30Z",
      "renewable_up_to": "2026-07-01T12:10:00Z",
      "settlement_day": "d0",
      "amount_from": 1000.0,
      "amount_to": 5050.0,
      "rate": 5.050,
      "settlement_eta": "2026-07-01T19:00:00Z",
      "wallet_id": "...",
      "pix_key": null,
      "error_detail": "",
      "webhook": "https://yourapp.com/webhooks/nox"
    }
  }
  ```

  ```json 404 theme={null}
  { "error": "Not Found" }
  ```
</ResponseExample>