---
title: "Create a quote"
method: POST
path: "/payouts/v3/quote"
tags: ["Currency exchange"]
---

# Create a quote

`POST /payouts/v3/quote`

This endpoint generates an FX rate for a particular currency pair.

## Request body

- CreateQuoteRequest
  - `country` string, required — Country code of the destination. ISO-3166 country code ISO-3166 country code.
  - `source_currency` string — Currency code for the source amount. ISO-4217 currency code.
  - `destination_currency` string, required — Currency code for the destination amount. ISO-4217 currency code.
  - `source_amount` number, float — Payout source amount expressed in the currency indicated in `source_currency`. When creating a payout, specify the exact same amount specified in this parameter.
  - `destination_amount` number, float — Payout destination amount expressed in the currency indicated in `destination_currency`. When creating a payout, specify the exact same amount specified in this parameter.

## Response `200`

Quote created

- ResponseCreateQuote
  - `status_code` string, int — Quote generation status code.
  - `status` string — Quote generation status description.
  - `status_detail` string — Quote generation status detail.
  - `id` string — Unique ID generated for the quoted FX rate.
  - `created_date` string, date-time — Creation date and time for the quoted FX rate.
  - `expiration_date` string, date-time — Expiration date and time for the quoted FX rate.
  - `details` QuoteDetails
    - `country` string, ISO-3166 country code — Country code of the destination.
    - `source_amount` number — Payout source amount expressed in the currency indicated in source_currency.
    - `source_currency` string, ISO-4217 currency code — Currency code for the source amount.
    - `destination_amount` number — Payout destination amount expressed in the currency indicated in destination_currency.
    - `destination_currency` string, ISO-4217 currency code — Currency code for the destination amount.
    - `exchange_rate` number — dLocal's FX rate for the requested currency pair with the markup applied.
    - `exchange_rate_official` number — Official FX rate for the requested currency pair.
    - `country_markup_percentage` number — Markup rate for the destination currency, expressed as a percentage.
    - `exchange_rate_spread` number — dLocal's spread resulting from the application of the markup to the official FX rate.
  - `fees` Fees
    - `amount` number — Total fees amount applicable to the transaction.
    - `currency` string, ISO-4217 currency code — Currency for the total processing fees.
  - `taxes` Taxes
    - `amount` number — Total tax amount applicable to the transaction.
    - `currency` string, ISO-4217 currency code — Currency for the total taxes applied.
  - `debit` Debit
    - `amount` number — Total amount that would be debited from the merchant's balance.
    - `currency` string, ISO-4217 currency code — Currency for the debit to the merchant's balance.

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/dlocal/apis/payins.md) · [All operations](https://skmtc.net/dlocal/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dlocal/payins/revisions/d87e090020f9/schema)