Get Available Countries
Obtain the List of Available Countries
This request is useful to get all available countries where you can send parcels.
Click the PLAY button at the top right of this section to view real-time GET Requst examples. You can also click 'Show API Request' to view each post and see the server's response.
Additionally you can get a phone number prefix and postcode format for each country.
Response example:
{
"iso": "AT", Country code in ISO format. This code is necessary for making all other API requests, such as retrieving rates, arranging shipments, and specifying addresses.
"title": "Austrija", Country name in specified language. Language is set in Header x-api-lang-iso. Available languages: en, ru, lv
"postcode_required": true, This value determines if a postcode is necessary for addresses in this country. In other words, if postcode required, shipments orders to this country will be rejected if they do not include a postcode.
"postcode_format": "NNNN", The postcode valid format, where N is number, L - letter and C is country iso code
"call_prefix": "+43" The phone number prefix for this country
}
This data is rarely updated, so we suggest storing these values on your end instead of fetching them from our server each time.
The postcode_format is crucial for each country. Here's what each component represents:
- N - is number.
- L - is letter.
- C - country iso code.
Examples:
- NNNN: 1000
- C-NNNN: LV-1000
- LLL-LLL: ABC-GBD
- NN NNN: 10 256
- NN-LLL: 10-ABC
For Latvia, the appropriate format is C-NNNN (e.g., LV-1000), which means you also need to include the country ISO code. Postcodes that omit "LV-", such as 1000, will not be accepted and will result in an error.
You can also request this list in your preferred language, which means the country title will appear in the language you choose. To do this, set the language in the request header under x-api-lang-iso. The languages available values are en, ru, lv.