Поиск адреса по коду ФИАС или КЛАДР (API)

Ищет адрес по коду КЛАДР или ФИАС.

до улицы включительно по кодам КЛАДР и ФИАС;
до дома по коду ФИАС.

Ищет только по актуальным адресам. Поиск выполняется по точному совпадению идентификатора, не по вхождению

Запрос

Для пользователей подсказок DaData.ru:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/fias

Для пользователей standalone-подсказок:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/fias

Заголовки

Заголовок Описание

Content-Type

Тип данных в запросе: application/json или application/xml

Accept

Тип данных в ответе: application/json или application/xml

Authorization

API-ключ в формате: Token ВАШ_КЛЮЧ

Только для пользователей подсказок DaData.ru

Параметры

Параметр	Обязательный?	Описание
`query`	да	Код КЛАДР или ФИАС, по которому нужно получить подсказку

Ответ

Возвращает объект адреса, который соответствует искомому коду:

Поле	Тип данных	Описание
postal_code	string(10)	Почтовый индекс
region_fias_id	string(50)	Код ФИАС региона
region_kladr_id	string(20)	Код КЛАДР региона
region_with_type	string(150)	Регион с типом
region_type	string(10)	Тип региона (сокращенный)
region_type_full	string(50)	Тип региона
region	string(150)	Регион
area_fias_id	string(50)	Код ФИАС района в регионе
area_kladr_id	string(20)	Код КЛАДР района в регионе
area_with_type	string(150)	Район в регионе с типом
area_type	string(10)	Тип района в регионе (сокращенный)
area_type_full	string(50)	Тип района в регионе
area	string(150)	Район в регионе
city_fias_id	string(50)	Код ФИАС города
city_kladr_id	string(20)	Код КЛАДР города
city_with_type	string(150)	Город с типом
city_type	string(10)	Тип города (сокращенный)
city_type_full	string(50)	Тип города
city	string(150)	Город
city_district_fias_id	string(50)	Код ФИАС района города
city_district_kladr_id	string(20)	Код КЛАДР района города
city_district_with_type	string(150)	Район города с типом
city_district_type	string(10)	Тип района города (сокращенный)
city_district_type_full	string(50)	Тип района города
city_district	string(150)	Район города
settlement_fias_id	string(50)	Код ФИАС нас. пункта
settlement_kladr_id	string(20)	Код КЛАДР нас. пункта
settlement_with_type	string(150)	Населенный пункт с типом
settlement_type	string(10)	Тип населенного пункта (сокращенный)
settlement_type_full	string(50)	Тип населенного пункта
settlement	string(150)	Населенный пункт
planning_structure_fias_id	string(50)	Код ФИАС планировочной структуры
planning_structure_kladr_id	string(20)	Код КЛАДР планировочной структуры
planning_structure_with_type	string(150)	Планировочная структура с типом
planning_structure_type	string(10)	Тип планировочной структуры (сокращенный)
planning_structure_type_full	string(50)	Тип планировочной структуры
planning_structure	string(150)	Планировочная структура
street_fias_id	string(50)	Код ФИАС улицы
street_kladr_id	string(20)	Код КЛАДР улицы
street_with_type	string(150)	Улица с типом
street_type	string(10)	Тип улицы (сокращенный)
street_type_full	string(50)	Тип улицы
street	string(150)	Улица
house_fias_id	string(50)	Код ФИАС дома
house_kladr_id	string(20)	Код КЛАДР дома
house_type	string(10)	Тип дома
house	string(50)	Дом
block	string(50)	Корпус
building_type	string(10)	Тип строения
building	string(50)	Строение
cadastral_number	string(100)	Кадастровый номер
fias_id	string(50)	Код ФИАС: `HOUSE.HOUSEGUID` для домов `ADDROBJ.AOGUID` для улиц, н/п и вышестоящих объектов.
fias_level	string(10)	Уровень адреса по ФИАС: 1 — регион 3 — район 4 — город 5 — район города 6 — населенный пункт 7 — улица 8 — дом 65 — планировочная структура.
kladr_id	string(20)	Код КЛАДР
capital_marker	string(10)	Признак центра района или региона: 1 — центр района (Московская обл, Одинцовский р-н, г Одинцово) 2 — центр региона (Новосибирская обл, г Новосибирск) 3 — центр района и региона (Томская обл, г Томск) 4 — центральный район региона (Тюменская обл, Тюменский р-н) 0 — ничего из перечисленного (Московская обл, г Балашиха)
okato	string(20)	Код ОКАТО
oktmo	string(20)	Код ОКТМО
tax_office	string(10)	Код ИФНС для физических лиц
tax_office_legal	string(10)	Код ИФНС для организаций
fias_code	string(50)	Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД)
fias_actuality_state	string(10)	Признак актуальности адреса в ФИАС: 0 — актуальный 1–50 — переименован 51 — переподчинен 99 — удален
history_values[ ]	string[](250)	Список исторических названий объекта нижнего уровня. Если подсказка до улицы — это прошлые названия этой улицы, если до города — города.

Примеры

Запрос

{
  "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" 
}

либо

{
  "query": "77000000000292300" 
}

{
    "suggestions": [
        {
            "value": "г Москва, ул Трехгорный Вал",
            "unrestricted_value": "123022, г Москва, ул Трехгорный Вал",
            "data": {
                "postal_code": "123022",
                "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
                "region_kladr_id": "7700000000000",
                "region_with_type": "г Москва",
                "region_type": "г",
                "region_type_full": "город",
                "region": "Москва",
                "area_fias_id": null,
                "area_kladr_id": null,
                "area_with_type": null,
                "area_type": null,
                "area_type_full": null,
                "area": null,
                "city_fias_id": null,
                "city_kladr_id": null,
                "city_with_type": null,
                "city_type": null,
                "city_type_full": null,
                "city": null,
                "city_district_fias_id": null,
                "city_district_kladr_id": null,
                "city_district_with_type": null,
                "city_district_type": null,
                "city_district_type_full": null,
                "city_district": null,
                "settlement_fias_id": null,
                "settlement_kladr_id": null,
                "settlement_with_type": null,
                "settlement_type": null,
                "settlement_type_full": null,
                "settlement": null,
                "planning_structure_fias_id": null,
                "planning_structure_kladr_id": null,
                "planning_structure_with_type": null,
                "planning_structure_type": null,
                "planning_structure_type_full": null,
                "planning_structure": null,
                "street_fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
                "street_kladr_id": "77000000000292300",
                "street_with_type": "ул Трехгорный Вал",
                "street_type": "ул",
                "street_type_full": "улица",
                "street": "Трехгорный Вал",
                "house_fias_id": null,
                "house_kladr_id": null,
                "house_type": null,
                "house": null,
                "block": null,
                "building_type": null,
                "building": null,
                "fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
                "fias_code": "7700000000000002923",
                "fias_level": "7",
                "fias_actuality_state": "0",
                "kladr_id": "77000000000292300",
                "capital_marker": "0",
                "okato": "45286575000",
                "oktmo": "45380000",
                "cadastral_number": null,
                "tax_office": "7703",
                "tax_office_legal": "7703",
                "history_values": null,
                "source": null,
                "qc": null
            }
        }
    ]
}

Дерево страниц

Поиск адреса по коду ФИАС или КЛАДР (API)

Запрос

Заголовки

Параметры

Ответ

Примеры