# Get conversion quote

**POST /api/v1/conversions/quote**

Requests a currency conversion quote for the authenticated API key owner.


## Servers
- https://api.staging.lumepay.com: https://api.staging.lumepay.com ()



## Parameters
### Headers

- **X-API-KEY** (string)
  Public API key issued from the Lumepay API key management flow.

- **X-API-SECRET** (string)
  API secret paired with the public API key.




### Body: application/json (object)

- **fromAmount** (number)
  How much the customer wants to send or pay. Provide either fromAmount or toAmount, not both.

- **toAmount** (number)
  How much the customer wants to receive. Provide either toAmount or fromAmount, not both.

- **fromCurrency** (string)
  Currency the customer sends or pays with.

- **toCurrency** (string)
  Currency the customer wants to receive.

- **quoteIntent** (string)
  Use client_linked when the customer may confirm this quote. Use indicative when the customer only needs a preview price.



## Responses
### 200
Conversion quote returned successfully

#### Body: application/json (object)
object
### 400
Request validation failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 429
Cloudflare API rate limit exceeded

#### Body: application/json (object)
- **error** (string)

- **message** (string)


### 403
Authenticated API key is not allowed to perform this action

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 500
Unexpected server error

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])


### 401
API key authentication failed

#### Body: application/json (object)
- **code** (integer(int32))

- **message** (string)

- **httpStatus** (integer(int32))

- **requestId** (string)

- **timestamp** (string(date-time))

- **errors** (array[object])



[Powered by Bump.sh](https://bump.sh)