Page tree
Skip to end of metadata
Go to start of metadata

This method is used to load detailed information on regions. The list of regions may be limited to user-defined characteristics.

Request for List of Regions 

In order to use this process, a GET request should be sent to URL:

Request Parameters

The following parameters are supported:

No.

Field name

Description

Field type

Mandatory (yes/no)

1country_codesArray of country codes in the format ISO_3166-1_alpha-2string(2) [ ]no
2region_codeRegion code in the CDEK IS
integerno
3kladr_region_code

Code according to the Russian Classifier of Countries of the World

Deprecated field

string(255)no
4fias_region_guidRegion code according to the Federal Information Address SystemUUIDno
5sizeLimitation on the number of results displayed. Default value: 1,000integeryes, if page is specified
6pageNumber of the results page. Default value: 0integerno
7langLocalization. Default: “rus”string(3)no

Response to List of Regions request

The response is returned in JSON format:

No.

Field name

Description

Field type

Mandatory (yes/no)

1country_codeCountry code in the format ISO_3166-1_alpha-2string(2)yes
2countryRegion country namestring(255)yes
3regionRegion namestring(255)yes
4prefixRegion prefixstring(255)no
5region_codeRegion code in the CDEK ISintegerno
6kladr_region_code

Code according to the Russian Classifier of Countries of the World

Deprecated field

string(255)no
7fias_region_guidRegion code according to the Federal Information Address SystemUUIDno
8errorsList of errors (if any)error[]no
8.1codeError code (if any)string()yes
8.2messageError description (if any)string()yes
Samples Requests
https://api.cdek.ru/v2/location/regions?size=3&page=0
https://api.cdek.ru/v2/location/regions?country_codes=RU,TR
Sample Response
[
    {
        "country_code": "TR",
        "region": "Ыгдыр",
        "country": "Турция"
    },
    {
        "country_code": "CN",
        "region": "аймак Алашань",
        "country": "Китай (КНР)"
    },
    {
        "country_code": "RU",
        "region": "Тверская",
        "region_code": 50,
        "country": "Россия",
        "prefix": "область",
        "kladr_region_code": "69",
        "fias_region_guid": "61723327-1c20-42fe-8dfa-402638d9b396"
    }
]
  • No labels