curl --request POST \
--url https://sandbox-platform.jupico.com/v1/exchange-rates/convert \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"from": "USD",
"to": "GBP",
"amount": 250
}
'import requests
url = "https://sandbox-platform.jupico.com/v1/exchange-rates/convert"
payload = {
"from": "USD",
"to": "GBP",
"amount": 250
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({from: 'USD', to: 'GBP', amount: 250})
};
fetch('https://sandbox-platform.jupico.com/v1/exchange-rates/convert', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://sandbox-platform.jupico.com/v1/exchange-rates/convert';
const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({from: 'USD', to: 'GBP', amount: 250})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"success": true,
"message": "succeeded",
"code": "0",
"data": {
"from": "USD",
"to": "GBP",
"amount": 250,
"convertedAmount": 196.12,
"rate": 0.7845,
"fetchedAt": "2026-08-14T16:20:45.331Z"
}
}Convert currency
Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.
curl --request POST \
--url https://sandbox-platform.jupico.com/v1/exchange-rates/convert \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"from": "USD",
"to": "GBP",
"amount": 250
}
'import requests
url = "https://sandbox-platform.jupico.com/v1/exchange-rates/convert"
payload = {
"from": "USD",
"to": "GBP",
"amount": 250
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({from: 'USD', to: 'GBP', amount: 250})
};
fetch('https://sandbox-platform.jupico.com/v1/exchange-rates/convert', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://sandbox-platform.jupico.com/v1/exchange-rates/convert';
const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({from: 'USD', to: 'GBP', amount: 250})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"success": true,
"message": "succeeded",
"code": "0",
"data": {
"from": "USD",
"to": "GBP",
"amount": 250,
"convertedAmount": 196.12,
"rate": 0.7845,
"fetchedAt": "2026-08-14T16:20:45.331Z"
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
Converts an amount between two currencies.
Source currency to convert from. 3-letter ISO 4217 code, uppercase.
3"USD"
Target currency to convert to. 3-letter ISO 4217 code, uppercase.
3"GBP"
Amount to convert, expressed in the source currency. Must be greater than zero.
x > 0250
Response
The converted amount and the rate used.
Whether the request was processed successfully. Declines return HTTP 200 with success: false.
Human-readable result message.
Machine-readable result code. See the Error Codes reference.
The response payload.
Hide child attributes
Hide child attributes
Source currency the amount was converted from.
Target currency the amount was converted to.
Original amount submitted, in the source currency.
Converted amount in the target currency, rounded down to 2 decimal places.
Exchange rate applied to the conversion.
UTC timestamp of when the rate was retrieved from the rate provider.
Was this page helpful?

