Skip to main content
GET
GetMerchantPriceDetails
Part of the International Prices integration guide — see it for when and how to use this endpoint.

Query Parameters

merchantToken
string
required

Secret token (unique merchant ID) to be provided to the merchant by Global‑e.

Country
string
required

2-char ISO destination country code. Example: IL

Currency
string
required

3-char ISO currency code of the customer's country (destination country). Example: ILS

Response

200 - application/json

The set of price calculation parameters and rules for the requested destination country and currency.

The price calculation parameters and rules returned for a destination country and currency. Field names, types, and descriptions are taken verbatim from the docs "Parameters" (Response) table; currencyFormatSymbol and isGrossPrices appear only in the worked example (no table row) and are flagged in review §2.

countryCode
string

2-char ISO destination country code. Example: IL

countryCode3
string

3-char ISO destination country code. Example: ISR

countryName
string

The name of the destination country. Example: Israel

currencySymbol
string

The symbol of the currency in the destination country. Example: ₪

currencyCode
string

3-char ISO currency code of the customer's country (destination country). Example: ILS

currencyFormatSymbol
currencyFormatSymbol · object

Currency formatting flags. Inferred entirely from the worked example (no property table on the page); types inferred from the example values. See review §2.

currencyDecimalNominator
string

Currency decimal separator type. ("," or ".") Example: XX.XX XX,XX

currencyThousandSeparator
string

Currency thousands separator indicator. ("," or ".") Example: XXX.XXX XXX,XXX

currencyDecimalPlaces
integer<int32>

Currency decimal places. Example: 0

culture
string

The language or locale of the destination country. Example: he

baseCountryCode
string

Merchant's base country code 2-char ISO. Example: GB

baseCurrencySymbol
string

The symbol of the currency in the country or origin (merchant's country or base country). Example: £

baseCurrencyCode
string

The currency code in the merchant's base country.

baseCurrencyDecimalPlaces
integer<int32>

Currency decimal places in the base currency. Example: 2

isOperatedByGlobale
boolean

Whether the selected country is operated by Global-e. This flag is be used as a Mode indicator. True: yes. In this case, Global-e converts the prices and opens their checkout. False: no. Countries that are not operated by Global‑e must still be available for selection as a shipping destination on the merchant's site. However Global‑e functionality must be disabled for such countries.

currencyConversionRate
number

Conversion rate between the base currency (GBP in this example) and the converted currency (ILS in this example). Example: 284.001848944500

countryCoefficientRate
number

Price uplift as set for this destination country. Example: 1.050000

productClassCoefficients
object

Product uplift as set per product (if the product uplift is set, this parameter overrides the country uplift), TYPE = object of key or value pairs (string / decimal). Example: {"extra-charge": 1.05, "special": 1.1}

isGrossPrices
boolean

Present only in the worked example (no Parameters-table row); type inferred from the example value.

roundingRules
RoundingRule · object

List of rounding rules that are applied when converting the prices, based on the rounding rule ranges and business rules.

vatSettings
vatSettings · object

VAT settings and calculation. Only applicable to European countries. Properties verbatim from the "VAT Settings" > VAT Options property table.