DOCS

Localization exchange api legacy

/

Localization Exchange API Legacy

Learn how the Legacy Localication Exchange API works.

The localization exchange API returns localization data that contains country specifics, currencies, and exchange rates.

Endpoints 

Retrieve localization data

GET | https://api.iglobalstores.com/2.0/localizationExchange - Retrieves localization data that includes country-level information plus local currency and exchange rate details.

HTTPS request

FieldNotes
HTTP methodGET
Endpoint URLhttps://test-api.iglobalstores.com/2.0/localizationExchange
ProtocolHTTPS
Message formatJSON
Accept HTTP headerAccept: application/json
Security Token HTTP headerserviceToken: your-test-token-valueAdd a header to your HTTPS request named serviceToken with a value of your test security API token. (Contact your Account Manager for this token.)

URL request parameters 

FieldNotes
countryCodeTwo-character country code of the given country stored inside the country-specific map for convenience; also stored as the key used to retrieve the country-specific map.Example values: CA or AU
format (recommended)True or false value to indicate whether or not to return formatting information.

HTTPS response

Message format: JSON

Example response (Canada only)

1
2
3
4
5
6
7
8
9
10
11
12
{
  "CA": {
    "code": "CA",
    "currency": "CAD",
    "currencySymbol": "$",
    "decimalDelimiter": ".",
    "name": "Canada",
    "rateEstimate": "1.42813",
    "scale": "2",
    "thousandsDelimiter": ","
  }
}

Response JSON definitions

FieldNotes
countryThis is a map with the keys being two-character country codes and values being maps that contain the name, code, and currency code of the specific country.
country[country_code].codeTwo-character country code of the given country stored inside the country-specific map for convenience; also stored as the key used to retrieve the country-specific map.Example values: CA or AU
country[country_code].currencyThe two-character currency code to use with this country.For some countries, it is best to use USD, because their currency fluctuates in value too dramatically.Example values: CAD or AUD or USD
country[country_code].currencySymbolThe symbol used to identify that currency in the browser.
country[country_code].decimalDelimiterAppears only if format query parameter is true; shows the character used for the decimal point for currency.
country[country_code].rateEstimateThe rate to multiply by to convert USD to the specific currency for estimated foreign pricing. You would use this rate when you intend to charge the customer in USD but show prices localized to their foreign currency.For example, 10 USD multiplied by 1.0312 (the rate given for CAD) = 10.31 CAD (price in CAD rounded using the “half up” method). Example values: 1.0312 or 0.8501 (Rates may contain up to 6 digits of precision, i.e. 1.123456.)
country[country_code].thousandDelimiterAppears only if format query parameter is true. Shows that character that indicates divide between thousand/million/billion marker for currency.
format (recommended)True or false value to indicate whether or not to return formatting information.

Was this page helpful?