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_guidRegion code according to the Federal Information Address SystemUUIDno
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: 1,000integeryes, if page is specified
11pageNumber of the results page. Default value: 0integerno
12langLocalization. Default: “rus”string(3)no
13payment_limitCash-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.
floatno

Response to List of Cities request

The response is returned in JSON format:

No.

Tag/ attribute

Description

Type of field

Mandatory (yes/no)

1codeCity code from the CDEK ISintegeryes
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_guidRegion code according to the Federal Information Address SystemUUIDno
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_limitCash-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.
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",
        "kladr_code": "11",
        "country": "Россия",
        "region": "Коми",
        "region_code": "1",
        "kladr_region_code": "11",
        "fias_region_guid": "c20180d9-ad9c-46d1-9eff-d60bc424592a",
        "sub_region": "Княжпогостский",
        "city": "Чиньяворык",
        "longitude": 52.6702,
        "latitude": 63.2087,
        "time_zone": "Europe/Moscow",
        "payment_limit": 0.0
    },
    {
        "code": "60049",
        "country_code": "RU",
        "fias_guid": "98eb8fd9-1ea0-457b-b539-ba6396eb6e01",
        "kladr_code": "50",
        "country": "Россия",
        "region": "Московская",
        "region_code": "9",
        "kladr_region_code": "50",
        "fias_region_guid": "29251dcf-00a1-4e34-98d4-5c47484a36d4",
        "sub_region": "Можайский",
        "city": "Поченичено",
        "longitude": 35.9312,
        "latitude": 55.3636,
        "time_zone": "Europe/Moscow",
        "payment_limit": -1.0
    },
    {
        "code": "16584",
        "postal_codes": [
            "353650",
            "353651"
        ],
        "country_code": "RU",
        "fias_guid": "c51d14cc-045c-4790-83c2-56febe8f8fa9",
        "kladr_code": "23",
        "country": "Россия",
        "region": "Краснодарский",
        "region_code": "7",
        "kladr_region_code": "23",
        "fias_region_guid": "d00e1013-16bd-4c09-b3d5-3cb09fc54bd8",
        "sub_region": "Ейский",
        "city": "Камышеватская",
        "longitude": 37.9554,
        "latitude": 46.4119,
        "time_zone": "Europe/Moscow",
        "payment_limit": -1.0
    }
]
  • No labels