Skip to content
English
  • There are no suggestions because the search field is empty.

FX exchange rate endpoint

REST API · FX Exchange Rate

Know exactly what the recipient gets, before you send it

The FX exchange rate endpoint tells you the delivery amount in the recipient's local currency — here's how to call it and read the response.

Endpoint

/operators/fx-rate

Method

POST

Level

Technical

The FX exchange rate endpoint returns the amount the end-user should receive, in their own local currency. For example, if your account is in Indian Rupees (INR) and you're topping up a number registered to Natcom Haiti, the fxRate returned will be 1.16 — meaning 1 INR equals 1.16 HTG.

Before you call it

You'll need an access token, passed in your request header, just like any other authenticated Reloadly endpoint. See our article on sending your first API request if you haven't obtained one yet.

Sample request and response

The example below uses Postman, but the same call works in any programming language. Pass the operator ID and the amount you intend to send:

POST https://topups.reloadly.com/operators/fx-rate Send
ParamsAuthorizationHeaders (10)Body

Request body (raw JSON)

{
  "operatorId": "255",
  "amount": "50"
}
Body CookiesHeaders (14) 200 OK 1218 ms635 B

Response

{
  "id": 255,
  "name": "Flow Jamaica",
  "fxRate": 7672.49985,
  "currencyCode": "JMD"
}
ℹ️ The delivery amount the recipient gets is the value in the fxRate field of the response — that's the number to surface in your UI or logs, not the raw amount you sent in the request.
💡 Tip: detailed documentation and sample code snippets for different programming languages are available in our developer docs — check there if you're not working in Postman directly.

Getting an unexpected fxRate value?

Our support team can help you double-check the call.

Contact support →