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

# Get exchange rates

`GET /v1/exchange-rates`

## Request

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

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`: InvalidToken
- `404`: Exchange not found
- `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)