Global Exchange Rates
HomeDocsDeveloper API Portal
HomeDocsDeveloper API Portal
  1. Conversion
  • Introduction
  • Authentication
  • Formats
  • Rate limiting and quotas
  • Errors
  • Client libraries
  • Currencies
    • /currencies
      GET
  • Exchange Rates
    • /latest
      GET
    • /historical
      GET
  • Providers
    • /providers
      GET
  • Conversion
    • /convert
      GET
  1. Conversion

/convert

GET
https://api.globalexchangerates.org/v1/convert
Conversion
Converts amounts between currencies.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.globalexchangerates.org/v1/convert?date&base&to&amount&provider&decimals&format&header' \
--header 'Subscription-Key;'
Response Response Example
200 - Success
{
    "provider": "GLOBAL",
    "date": "2025-04-07",
    "base": "EUR",
    "amount": 1.0,
    "conversions": {
        "AED": 3.9628755802,
        "AFN": 77.2385000000,
        "ALL": 98.5618211802,
        "AMD": 422.1071538005,
        "ANG": 1.9327000000,
        "AOA": 988.9800313588,
        "ARS": 1157.2549184417,
        "AUD": 1.7246645496,
        "AWG": 1.9290669688,
        "AZN": 1.8321557429,
        "BAM": 1.9503972974,
        "BBD": 2.1593492684,
        "BDT": 131.0641334443,
        "BGN": 1.9519177022,
        "BHD": 0.4062112461,
        "BIF": 3163.8274829268,
        "BMD": 1.0800925436,
        "BND": 1.4505352963,
        "BOB": 7.4404495472,
        "BRL": 6.1722093082,
        "BSD": 1.0800921256,
        "BTN": 92.4045533100,
        "BWP": 14.7774118804,
        "BYN": 3.5325481777,
        "BZD": 2.1602737284,
        "CAD": 1.5513179655,
        "CDF": 3091.3480441116,
        "CHF": 0.9529992047,
        "CLP": 1023.5471340823,
        "CNY": 7.8374789128,
        "COP": 4504.5804610126,
        "CRC": 538.0121730697,
        "CUP": 25.8912000000,
        "CVE": 110.2575017420,
        "CZK": 24.9109878139,
        "DJF": 191.6332048084,
        "DKK": 7.4491165343,
        "DOP": 67.9140278123,
        "DZD": 143.9502900716,
        "EGP": 54.5449932559,
        "ERN": 16.4474048084,
        "ETB": 141.3726715165,
        "FJD": 2.5013590244,
        "FKP": 0.8366500000,
        "GBP": 0.8353276134,
        "GEL": 2.9633996441,
        "GHS": 16.7204445992,
        "GIP": 0.8366500000,
        "GMD": 77.3273728224,
        "GNF": 9296.5018459232,
        "GTQ": 8.2794818234,
        "GYD": 225.5468825784,
        "HKD": 8.3916999587,
        "HNL": 27.4889997598,
        "HTG": 140.8153000000,
        "HUF": 402.0135749197,
        "IDR": 17927.3255881922,
        "ILS": 3.9987538408,
        "INR": 92.2164737401,
        "IQD": 1415.1518715516,
        "IRR": 739520.0000000000,
        "ISK": 142.8618569866,
        "JMD": 169.7343754008,
        "JOD": 0.7659639894,
        "JPY": 161.1618241989,
        "KES": 139.3375531490,
        "KGS": 93.5150315680,
        "KHR": 4302.0803024953,
        "KMF": 492.3490681184,
        "KPW": 2.3734000000,
        "KRW": 1588.1088514673,
        "KWD": 0.3324738628,
        "KYD": 0.8852001491,
        "KZT": 543.0462935055,
        "LAK": 22724.7003057120,
        "LBP": 96393.7288541319,
        "LKR": 319.5184148716,
        "LRD": 214.9984021604,
        "LSL": 19.7999886968,
        "LYD": 5.1937635931,
        "MAD": 10.3771559457,
        "MDL": 19.3399242150,
        "MGA": 5007.2515818816,
        "MKD": 61.3744484611,
        "MMK": 2267.6507002993,
        "MNT": 3769.4589965156,
        "MOP": 8.6539886412,
        "MRU": 42.9597144252,
        "MUR": 48.9951116237,
        "MVR": 16.6775654005,
        "MWK": 1865.3618539372,
        "MXN": 22.0834663736,
        "MYR": 4.7836323747,
        "MZN": 68.7220104712,
        "NAD": 19.8067664808,
        "NGN": 1654.6238708736,
        "NIO": 39.6646422300,
        "NOK": 11.3209663427,
        "NPR": 148.0246761367,
        "NZD": 1.8985809303,
        "OMR": 0.4150590278,
        "PAB": 1.0698361963,
        "PEN": 3.9545283009,
        "PGK": 4.3599760841,
        "PHP": 61.8230320575,
        "PKR": 302.2136291971,
        "PLN": 4.1785224675,
        "PYG": 8624.4710801392,
        "QAR": 3.9299811014,
        "RON": 4.9669282158,
        "RSD": 116.8026792996,
        "RUB": 91.2702172751,
        "RWF": 1521.8257331708,
        "SAR": 4.0468885628,
        "SBD": 8.9975000000,
        "SCR": 15.8582707692,
        "SDG": 647.8260687377,
        "SEK": 10.8118785839,
        "SGD": 1.4482878166,
        "SHP": 0.8366500000,
        "SLE": 24.5745000000,
        "SOS": 616.3940000000,
        "SRD": 39.2669783972,
        "SSP": 4804.3309000000,
        "STN": 24.5000000000,
        "SVC": 9.4506455052,
        "SYP": 13270.0686950354,
        "SZL": 19.8038375608,
        "THB": 36.7405305939,
        "TJS": 11.7529292100,
        "TMT": 3.7784763621,
        "TND": 3.3483325384,
        "TOP": 2.5636890592,
        "TRY": 40.8676123869,
        "TTD": 7.3067939749,
        "TWD": 35.8512944271,
        "TZS": 2837.4686876354,
        "UAH": 44.6180393715,
        "UGX": 3948.9326589467,
        "USD": 1.0789549802,
        "UYU": 45.3833932001,
        "UZS": 13960.0618301697,
        "VES": 74.9069140535,
        "VND": 27617.8620039793,
        "VUV": 132.5700000000,
        "WST": 3.0026698256,
        "XAF": 655.6097540068,
        "XCD": 2.9118890592,
        "XOF": 655.1754682928,
        "YER": 265.1763727589,
        "ZAR": 19.7963071074,
        "ZMW": 30.3641222129,
        "ZWG": 28.8816000000
    }
}

Request

Authorization
API Key
Add parameter in header
Subscription-Key
Example:
Subscription-Key: ********************
or
API Key
Add parameter in query
subscription-key
Example:
subscription-key: ********************
or
Query Params
date
string <YYYY-MM-DD>
optional
Date in format YYYY-MM-DD. Must be >= 2024-01-01 (2025-01-01 for GLOBAL)
base
string 
optional
Base currency for rates conversion. Only valid for GLOBAL provider. Default is EUR
to
string 
optional
Comma-separated list of currencies to convert to (e.g., USD,EUR,GBP)
amount
number 
required
The amount to be converted. Mandatory.
provider
string 
optional
Provider code. Default is GLOBAL.
decimals
integer 
optional
Format - int32. Number of decimal places for rates (0-10). Default is 10
format
string 
optional
Response format. Allowed values: JSON (default), XML, CSV
header
boolean 
optional
For CSV format only. Include header row if true. Default is false

Responses

🟢200Success
application/json, application/xml, text/csv
Currency conversion.
Body
provider
string 
required
date
string 
required
base
string 
required
amount
integer 
required
conversions
object  | null 
required
🟠400Bad Request
Modified at 2025-04-07 13:24:01
Previous
/providers
Built with