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:
Request body (raw JSON)
{
"operatorId": "255",
"amount": "50"
}
Response
{
"id": 255,
"name": "Flow Jamaica",
"fxRate": 7672.49985,
"currencyCode": "JMD"
}
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.
Getting an unexpected fxRate value?
Our support team can help you double-check the call.