List of Cities


 

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:

Environment

URL

testing

https://api.edu.cdek.ru/v2/location/cities

production

https://api.cdek.ru/v2/location/cities

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

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 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


https://api.cdek.ru/v2/location/cities/?size=3&page=0
https://api.cdek.ru/v2/location/cities/?country_codes=RU,TR


[
    {
        "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"
    }
]


 

© 2000—2022, Курьерская компания СДЭК