---
title: "Retrieve the receiving conversion rate"
method: GET
path: "/banks/{product}/rate"
tags: ["virtual accounts"]
---

# Retrieve the receiving conversion rate

`GET /banks/{product}/rate`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hevn-inc/apis/hevn-api/docs/banks/:product/rate/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the current conversion rate and fixed fee for this receiving payment method. The result is indicative until an incoming transfer is created.

## Path parameters

- `product` 'us' | 'swift' | 'eu' | 'uae' | 'uk' | 'br' | 'mx' | 'co' | 'ar' | 'au' | 'ng' | 'ca' | 'dk' | 'no' | 'pl' | 'tr' | 'il' | 'sa' | 'bo' | 'cl' | 'cr' | 'do' | 'gt' | 'hn' | 'jm' | 'eg' | 'sl' | 'tz' | 'ug' | 'waemu' | 'zm' | 'bd' | 'cn' | 'hk' | 'in' | 'id' | 'jp' | 'my' | 'pk' | 'ph' | 'kr' | 'th' | 'vn' | 'card', required

## Headers

- `X-Hevn-Account` string, nullable: The client account to act for, as a `cl_…` id. Omit it to act as yourself.

## Response `200`

Successful Response

- RailRateView
  - `currency` string, required: ISO 4217 fiat currency code for this conversion.
  - `rate` string, nullable: Conversion rate net of markup, when currently available.
  - `fixedFee` string, nullable: Fixed fee component, when charged.
  - `fixedFeeCurrency` string, nullable: Currency in which the fixed fee is charged.

## Other responses

- `422`: Request validation failed

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)