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

# Create exchange rate

`POST /v1/exchange-rates`

Define the exchange rate for international transactions.

You **must** use this endpoint or [Pismo Control Center](https://developers.pismo.io/pismo-docs/docs/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` — Access token is missing or invalid
- `422` — Unprocessable Entity
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)