---
title: "Create exchange rate"
method: POST
path: "/v1/exchange-rates"
tags: ["Exchange rates"]
---

# Create exchange rate

`POST /v1/exchange-rates`

## Request

- Base URL: `https://sandbox.pismolabs.io/rates`
- URL: `https://sandbox.pismolabs.io/rates/v1/exchange-rates`
- Auth: HTTP bearer

Define the exchange rate for international transactions.

You **must** use this endpoint or [Pismo Control Center](doc:exchange-rates) to define the exchange rate for today or tomorrow.

Exchange rates are defined at the organization level but, optionally, you can define rates for a specific program and the platform uses this rate and not the org rate for all program-related transactions.


**Note:**  For more information, refer to [Exchange rates for international transactions](https://developers.pismo.io/pismo-docs/docs/exchange-rate#exchange-rates-for-international-transactions).

## Headers

- `Authorization` string, required

## Request body

- ExchangeRates
  - `date` string, date, required: Date for today or tomorrow, format = yyyy-mm-dd.
  - `destination_currency_id` string, required: Destination ISO 4217 currency.
  - `origin_currency_id` string, required: Origin ISO 4217 currency.
  - `exchange_rate` number, required: Wholesale exchange rate amount to 4 decimal places in the destination currency. For example 4.8123.
  - `spread` number, required: Day rate multiplier to 4 decimal places. For example, 1.1205 is equivalent to 1.1205%, 15.12 is equivalent to 15.12%..
  - `hour` string, time: Hour in UTC time zone, format = HH:MM:SSZ. Using this field, you be able to work with seconds precision in your international purchases. **Note:** This field will be validated considering an offset of UTC subtracted three seconds just in the validation layer, to prevent you to need increase a few seconds just to pass our validation.
  - `program_id` number: Pismo program ID
  - `apply_fees_without_spread` boolean: Whether `spread` should be ignored in exchange transactions when calculating fee model taxes. Default = `false`.

## Response `201`

Created

## Other responses

- `400`: Bad Request
- `401`: InvalidToken
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/platform-setup-rates-and-fees.md) - [All operations](https://skmtc.dev/pismo/apis/platform-setup-rates-and-fees/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-setup-rates-and-fees/revisions/9b015a025dd8?raw)