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,
  "conversions": {
    "AED": 3.9628755802,
    "AFN": 77.2385,
    "ALL": 98.5618211802,
    "AMD": 422.1071538005,
    "ANG": 1.9327,
    "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.40455331,
    "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.8912,
    "CVE": 110.257501742,
    "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.83665,
    "GBP": 0.8353276134,
    "GEL": 2.9633996441,
    "GHS": 16.7204445992,
    "GIP": 0.83665,
    "GMD": 77.3273728224,
    "GNF": 9296.5018459232,
    "GTQ": 8.2794818234,
    "GYD": 225.5468825784,
    "HKD": 8.3916999587,
    "HNL": 27.4889997598,
    "HTG": 140.8153,
    "HUF": 402.0135749197,
    "IDR": 17927.3255881922,
    "ILS": 3.9987538408,
    "INR": 92.2164737401,
    "IQD": 1415.1518715516,
    "IRR": 739520,
    "ISK": 142.8618569866,
    "JMD": 169.7343754008,
    "JOD": 0.7659639894,
    "JPY": 161.1618241989,
    "KES": 139.337553149,
    "KGS": 93.515031568,
    "KHR": 4302.0803024953,
    "KMF": 492.3490681184,
    "KPW": 2.3734,
    "KRW": 1588.1088514673,
    "KWD": 0.3324738628,
    "KYD": 0.8852001491,
    "KZT": 543.0462935055,
    "LAK": 22724.700305712,
    "LBP": 96393.7288541319,
    "LKR": 319.5184148716,
    "LRD": 214.9984021604,
    "LSL": 19.7999886968,
    "LYD": 5.1937635931,
    "MAD": 10.3771559457,
    "MDL": 19.339924215,
    "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.66464223,
    "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.9975,
    "SCR": 15.8582707692,
    "SDG": 647.8260687377,
    "SEK": 10.8118785839,
    "SGD": 1.4482878166,
    "SHP": 0.83665,
    "SLE": 24.5745,
    "SOS": 616.394,
    "SRD": 39.2669783972,
    "SSP": 4804.3309,
    "STN": 24.5,
    "SVC": 9.4506455052,
    "SYP": 13270.0686950354,
    "SZL": 19.8038375608,
    "THB": 36.7405305939,
    "TJS": 11.75292921,
    "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.57,
    "WST": 3.0026698256,
    "XAF": 655.6097540068,
    "XCD": 2.9118890592,
    "XOF": 655.1754682928,
    "YER": 265.1763727589,
    "ZAR": 19.7963071074,
    "ZMW": 30.3641222129,
    "ZWG": 28.8816
  }
}

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
Previous
/providers
Built with