---
title: "Get exchange rates"
method: GET
path: "/v1/exchange-rates"
tags: ["Exchange rates"]
---

# Get exchange rates

`GET /v1/exchange-rates`

Returns exchange rates with paging and filter options

## Query parameters

- `beginCreatedAt` string, required
- `endCreatedAt` string, required
- `perPage` integer, required
- `page` integer, required
- `programId` integer

## Headers

- `Authorization` string, required

## Response `200`

OK

- Exchanges[]
  - `last_page` boolean — Is this the last page flag
  - `exchange_rates` Exchange[]
    - `exchange_rate_id` number, required — Exchange ID
    - `origin` string, required — Origin ISO 4217 currency code.
    - `destination` string, required — Destination ISO 4217 currency code.
    - `program_id` number, required — Pismo program ID.
    - `conversion_rate` number, required — Fee charged for the conversion as decimal number.
    - `spread` number, required — Day rate multiplier to two decimal places (hundredths), 1.05 = 1.05%, 15 = 15%, and so on.
    - `exchange_rate` number, required — Wholesale exchange rate amount in the destination currency as decimal number.
    - `created_date` string, required — Exchange rate created date.
    - `date` string, required — Exchange rate start date, format = yyyy-mm-dd.
    - `hour` string, required — Exchange rate start time, format = hh:mm:ssZ.
    - `apply_fees_without_spread` boolean — Flag that indicates whether spread should be disconsidered in exchange transactions when calculating fee model taxes. If not informed, false will be assumed.

## Other responses

- `400` — Bad Request
- `401` — Access token is missing or invalid
- `404` — Exchange not found
- `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)