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

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

Request for List of Cities

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

Parameters Body

The following parameters are supported:

No.

Tag/ attribute

Description

Type of field

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

Region code according to the Russian Classifier of Countries of the World

Deprecated field

string(255)no
4fias_region_guid

Region code according to the Federal Information Address System

Deprecated field

UUIDno
5kladr_code

City code according to the Russian Classifier of Countries of the World

Deprecated field

string(255)no
6fias_guidCity code according to the Federal Information Address SystemUUIDno
7postal_codePostal codestring(255)no
8codeCity code from the CDEK ISintegerno
9cityCity namestring(255)no
10sizeLimitation on the number of results displayed. Default value: 500integeryes, if page is specified
11page

Number of the results page. Default value: 0

Deprecated field. It is recommended to use the location (contains a link to the next page) response header for page loading.

integerno
12langLocalization. Default: “rus”string(3)no
13payment_limit

Cash-on-delivery amount limit, possible values:
1 – no limit;
0 – cash on delivery is not accepted;
positive value – the cash-on-delivery amount does not exceed this value.

Deprecated field

floatno

Response to List of Cities request

The response header: location - contains a link to the next page for page loading.

The response body is returned in JSON format:

No.

Tag/ attribute

Description

Type of field

Mandatory (yes/no)

1codeCDEK location codeintegeryes
2cityCity namestring(255)yes
3fias_guidCity code according to the Federal Information Address SystemUUIDno
4kladr_code

Region code according to the Russian Classifier of Countries of the World

Deprecated field

string(255)no
5country_codeCountry code in the format ISO_3166-1_alpha-2string(2)yes
6countryCity country namestring(255)yes
7regionRegion namestring(255)yes
8region_codeRegion code in the CDEK IS
integerno
9fias_region_guid

Region code according to the Federal Information Address System

Deprecated field

UUIDno
10kladr_region_code

Code according to the Russian Classifier of Countries of the World

Deprecated field

string(255)no
11sub_regionName of region's districtstring(255)no
12postal_codesCity postal codes

[ ]

no
13longitudeLatitudefloatno
14latitudeLongitudefloatno
15time_zoneCity timezonestring(255)no
16payment_limit

Cash-on-delivery amount limit, possible values:
1 – no limit;
0 – cash on delivery is not accepted;
positive value – the cash-on-delivery amount does not exceed this value.

Deprecated field

floatyes
17errorsList of errors (if any)error[]no
17.1codeError code (if any)string()yes
17.2messageError description (if any)string()yes
Samples Requests
https://api.cdek.ru/v2/location/cities/?size=3&page=0
https://api.cdek.ru/v2/location/cities/?country_codes=RU,TR
Sample Response
[
    {
        "code": "36749",
        "postal_codes": [
            "169237"
        ],
        "country_code": "RU",
        "fias_guid": "62e29404-83cc-4dd8-a46a-7d28464b9df8"
        "country": "Россия",
        "region": "Коми",
        "region_code": "1",
        "sub_region": "Княжпогостский",
        "city": "Чиньяворык",
        "longitude": 52.6702,
        "latitude": 63.2087,
        "time_zone": "Europe/Moscow"
    },
    {
        "code": "60049",
        "country_code": "RU",
        "fias_guid": "98eb8fd9-1ea0-457b-b539-ba6396eb6e01"
        "country": "Россия",
        "region": "Московская",
        "region_code": "9",
        "sub_region": "Можайский",
        "city": "Поченичено",
        "longitude": 35.9312,
        "latitude": 55.3636,
        "time_zone": "Europe/Moscow"
    },
    {
        "code": "16584",
        "postal_codes": [
            "353650",
            "353651"
        ],
        "country_code": "RU",
        "fias_guid": "c51d14cc-045c-4790-83c2-56febe8f8fa9",
        "country": "Россия",
        "region": "Краснодарский",
        "region_code": "7",
        "sub_region": "Ейский",
        "city": "Камышеватская",
        "longitude": 37.9554,
        "latitude": 46.4119,
        "time_zone": "Europe/Moscow"
    }
]
  • No labels