Идентификатор фиас как его найти

↑ Все API

Адрес в ФИАС по идентификатору

⚠️ В большинстве случаев вам нужен не этот метод, а адрес по ФИАС-коду

Находит адрес в справочнике ФИАС по коду КЛАДР или ФИАС.

Как вызвать

Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

Пример запроса:

curl -X POST 
-H "Content-Type: application/json" 
-H "Accept: application/json" 
-H "Authorization: Token ${API_KEY}" 
-d '{ "query": "9120b43f-2fae-4838-a144-85e43c2bfb29" }' 
https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/fias

// https://github.com/hflabs/dadata-csharp

var token = "${API_KEY}";
var api = new SuggestClientAsync(token);
var result = await api.FindFias("9120b43f-2fae-4838-a144-85e43c2bfb29");
var address = response.suggestions[0].data;

var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/fias";
var token = "${API_KEY}";
var query = "9120b43f-2fae-4838-a144-85e43c2bfb29";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));

// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new DadataDadataClient($token, null);
$result = $dadata->findById("fias", "9120b43f-2fae-4838-a144-85e43c2bfb29", 1);

# https://github.com/hflabs/dadata-py

from dadata import Dadata
token = "${API_KEY}"
dadata = Dadata(token)
result = dadata.find_by_id("fias", "9120b43f-2fae-4838-a144-85e43c2bfb29")

По КЛАДР-коду ищет до улицы, по ФИАС-коду — до дома. По ФИАС-коду квартиры не ищет.

ФИАС-коды домов иногда меняются, а метод ищет только по актуальным кодам. Поэтому рекомендуем помимо ФИАС-кода дома сохранять адрес одной строкой — иначе не получится восстановить адрес, когда ФИАС-код изменится.

Что в ответе

Пример ответа

{
    "suggestions": [
        {
            "value": "г Москва, ул Снежная",
            "unrestricted_value": "129323, г Москва, ул Снежная",
            "data": {
                "postal_code": "129323",
                "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": "9120b43f-2fae-4838-a144-85e43c2bfb29",
                "street_kladr_id": "77000000000268400",
                "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": "9120b43f-2fae-4838-a144-85e43c2bfb29",
                "fias_code": null,
                "fias_level": "7",
                "fias_actuality_state": "0",
                "kladr_id": "77000000000268400",
                "capital_marker": "0",
                "okato": null,
                "oktmo": null,
                "cadastral_number": null,
                "tax_office": "7716",
                "tax_office_legal": "7716",
                "history_values": null,
                "source": null,
                "qc": null
            }
        }
    ]
}

  1 — регион
  3 — район
  4 — город
  5 — район города
  6 — населенный пункт
  7 — улица
  8 — дом
 65 — планировочная структура

  0    — актуальный
  1–50 — переименован
  51   — переподчинен
  99   — удален

  1 — центр района
      (Московская обл, Одинцовский р-н, г Одинцово)
  2 — центр региона
      (Новосибирская обл, г Новосибирск)
  3 — центр района и региона
      (Томская обл, г Томск)
  4 — центральный район региона
      (Тюменская обл, Тюменский р-н)
  0 — ничего из перечисленного
      (Московская обл, г Балашиха)

Источник данных: Федеральная информационная адресная система (ФИАС) Налоговой службы.

Примеры вызова

• PHP

• PHP (одним файлом)

• Python

• R

• Symfony

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.