---
title: "Quote a USD to KES conversion"
method: GET
path: "/v1/conversions/quote"
tags: ["Partner API"]
---

# Quote a USD to KES conversion

`GET /v1/conversions/quote`

## Request

- Base URL: `https://sandbox.onlink.africa`
- URL: `https://sandbox.onlink.africa/v1/conversions/quote`
- Auth: API key in header `X-OnLink-Key`

An indicative rate and the KES you would receive for an amount of USD now. Nothing is reserved: the bank fixes its rate when a conversion executes, so the executed rate can differ slightly.

## Query parameters

- `from` string, required
- `to` string, required
- `amount` string, required

## Response `200`

The indicative quote.

- PartnerConversionQuoteResponseDto
  - `rate` string, required: KES per 1 USD you would be paid at now, to 2 decimal places. Indicative: the bank fixes its rate when the conversion executes.
  - `source` string, required: The USD amount, 2 decimal places.
  - `target` string, required: The KES you would receive at `rate`: `source x rate`, rounded down to the cent.
  - `indicative` boolean, required: Always true: a quote is not a commitment.
  - `asOf` string, required: When the rate was read, ISO 8601 UTC.

## Other responses

- `404`: PARTNER_NOT_FOUND.
- `422`: CONVERSION_PAIR_UNSUPPORTED, CONVERSION_AMOUNT_INVALID, CONVERSION_AMOUNT_BELOW_MINIMUM or CONVERSION_AMOUNT_ABOVE_MAXIMUM.
- `503`: PARTNER_CONVERSIONS_DISABLED or CONVERSION_RATE_UNAVAILABLE.

---

[API](https://skmtc.dev/onlink/apis/onlink-partner-api.md) - [All operations](https://skmtc.dev/onlink/apis/onlink-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlink/apis/onlink-partner-api/revisions/1d1c6a3671f2?raw)