---
title: "Get quote"
method: GET
path: "/api/v1/quote/{uuid}"
tags: ["Trading and Conversions"]
---

# Get quote

`GET /api/v1/quote/{uuid}`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/api/v1/quote/{uuid}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/api/v1/quote/:uuid/get.ts> (a function with typed inputs; its response is checked against the schema)

:::warning Transfers v.3 recommended
For conversions created through the [Transfers v.3 API](/bvnk/api-explorer/endpoints/transfer-create-v-3), query status with [`GET /payment/v3/transfers/{transferId}`](/bvnk/api-explorer/endpoints/transfer-read-v-3) instead. The flow differs from the legacy Quote API: v.3 reports a single `status` field rather than separate `quoteStatus` and `paymentStatus` values.

This endpoint remains available for retrieving quotes created via the legacy Quote API. See the [migration guide](/bvnk/use-cases/migrate-quote-to-transfers-v3) for details.
:::

Retrieves a specific quote.

## Path parameters

- `uuid` string, required

## Response `200`

OK

- QuoteDto
  - `id` integer: The ID of the quote.
  - `from` string: The currency to convert from.
  - `to` string: The currency to convert to.
  - `amountIn` number: The amount converted to.
  - `amountDue` number: The amount due to be converted.
  - `amountOut` number: The amount being converted out.
  - `price` number: The price quoted.
  - `quoteStatus` 'ESTIMATE' | 'PENDING' | 'ACCEPTED' | 'PAYMENT_IN_FAILED' | 'PAYMENT_OUT_PROCESSED' | 'CONVERSION_FAILED' | 'PAYMENT_OUT_FAILED' | 'REFUNDED': The status of the quote. You can expect it to remain in the `PENDING` status until you call `/api/v1/quote/accept/{uuid}` and the quote is accepted.
  - `paymentStatus` 'PENDING' | 'SUCCESS' | 'CANCELLED' | 'FAILED' | 'REFUND_PENDING' | 'REFUNDED' | 'REFUND_FAILED': The payment status that reflects the progress of the conversion. You can expect it to remain in the `PENDING` status until you call `/api/v1/quote/accept/{uuid}` and the quote is accepted.
  - `acceptanceExpiryDate` integer: The date and time, encoded into UNIX epoch timestamps.
  - `acceptanceDate` integer: The date and time, encoded into UNIX epoch timestamps.
  - `paymentExpiryDate` integer: The date and time, encoded into UNIX epoch timestamps.
  - `paymentReceiptDate` integer: The date and time, encoded into UNIX epoch timestamps.
  - `payInLegs` PaymentLegDto[]
    - `id` integer: The ID of the payment.
    - `amount` number: The amount of the payment.
    - `dateCreated` integer: The date and time, encoded into UNIX epoch timestamps.
    - `reference` string: The reference of the payment.
    - `currency` string: The currency of the payment.
  - `payInMethod` PayInMethodDto
    - `id` integer: The ID fo the pay in method.
    - `code` string: The code of the payin.
    - `settlementCurrency` string: The settlement currency of the pay in.
    - `requestedCurrency` string: The requested currency of the pay in.
    - `estimatedExchangeRate` number: The estimated exchange rate of the pay in.
    - `accountMethods` string[]
  - `payOutMethod` PayOutMethodDto
    - `id` integer: The ID of the pay out.
    - `code` string: The code of the pay out.
    - `currency` string: The currency of the pay out.
    - `accountMethods` string[]
  - `uuid` string: The UUID of the quote.
  - `payOutInstruction` string
  - `payInInstruction` PayInInstructionDto
    - `action` string
    - `form` string
    - `redirectUrl` string
    - `displayParameters` string
  - `usePayInMethod` AccountMethodDto
    - `id` integer: The account method ID.
    - `display` string: The display details of the account method.
  - `usePayOutMethod` AccountMethodDto
    - `id` integer: The account method ID.
    - `display` string: The display details of the account method.
  - `fee` number: The fee for the quote.
  - `processingFee` number: The processing fee.
  - `type` 'FIXED' | 'MARKET': The type of quote.
  - `netPrice` number: The net price fo the quote.
  - `grossPrice` number: The gross price of the quote.
  - `amountInGross` number: The price of the quote in gross.
  - `amountInNet` number: The price of the quote in net.
  - `fees` FeesDto
    - `percentage` FeeDto
      - `service` number
      - `processing` number
    - `value` FeeDto
      - `service` number
      - `processing` number
  - `dateCreated` integer: The date and time, encoded into UNIX epoch timestamps.
  - `lastUpdated` integer: The date and time, encoded into UNIX epoch timestamps.

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)