Countries

Returns the list of supported countries including the indication for each country if it is being operated by Global‑e or by the Merchant. If the Merchant’s site already includes its own list of countries, this list must be replaced with the list returned by this method.

Method/URL

https://{server_name}/Browsing/Countries

Parameters

Request

Parameter Name	Type	Description	Mandatory
`countryCode`	String	2-char ISO country code. If not specified, all the countries supported by the merchant will be returned	No
`cultureCode`	String	ISO culture code. If specified, the textual properties (for example `Name`) will be returned in the requested culture’s language. Texts in English will be returned by default for the countries where the texts for the requested culture are unavailable or if the `cultureCode` argument has not been specified.	No

Parameter Name

Type

Description

Mandatory

countryCode

String

2-char ISO country code.

If not specified, all the countries supported by the merchant will be returned

cultureCode

String

ISO culture code.

If specified, the textual properties (for example Name) will be returned in the requested culture’s language. Texts in English will be returned by default for the countries where the texts for the requested culture are unavailable or if the cultureCode argument has not been specified.

Response

Parameter Name	Type	Description	Mandatory
`Country`	List of `Country`	List of supported countries, list of object `Country`

Country

Parameter Name	Type	Description	Mandatory
`Code`	String	2-char ISO country code
`DefaultCurrencyCode`	String	3-char ISO currency code
`DefaultVATRateType`	Object `VATRateType`	Default (most widely used) VAT rate type or class for this country.	No
`IsOperatedByGlobalE`	Boolean	Flag to be used as a Mode indicator. Countries that are not operated by Global‑e can still be available for selection as a shipping destination on the Merchant site. However Global‑e functionality is disabled for such countries. TRUE - Country is operated by Global-e. FALSE - Country is not operated by Global-e.
`IsStateMandatory`	Boolean	Indicates if State or province (region) is mandatory for addresses in this country. TRUE - State is mandatory for address. FALSE - State is not mandatory for address.
`Name`	String	Country name
`SiteURL`	String	URL of a country-specific site owned by the Merchant. Used to allow redirection to the Merchant’s country-specific domain for a selected country.
`SupportsFixedPrices`	Boolean	Indicates if fixed product prices are allowed for this country. Product prices may be fixed only in the Default Currency for this Country. TRUE - Prices can be fixed. FALSE - Prices cannot be fixed.	No
`UseCountryVAT`	Boolean	TRUE if VAT rate specific to this shipping country must be applied to the product prices. Otherwise, VAT rates defined for the products on the Merchant’s site must be used. This setting is used to support trade agreements between the countries such as EEA, when the end customer must pay VAT for the shipping country in certain cases.	No

VATRateType

Parameter Name	Type	Description	Mandatory
`Name`	String	VAT rate type name	No
`Rate`	Decimal	VAT rate decimal value
`VATRateTypeCode`	String	VAT rate type (or class) code on the Merchant’s site (to be mapped on the Global-e side)

Documentation Portal

Countries

Parameters

Country

VATRateType

Search results