Датасет · в коробке — модуль «Адреса»: опция к «Скрининг»/«Комплаенс» или отдельная подписка, входит в «Масштаб»

Адреса (ГАР): подсказки и нормализация в вашем контуре

Локальная копия ГАР до дома: подсказки при вводе адреса и приведение его к канонической цепочке «регион → город → улица → дом» — безлимитно, вместо оплаты за каждый запрос.

Получить КП Все датасеты

Паспорт датасета
Источник	ФНС России, ГАР (fias.nalog.ru) — открытые данные по 443-ФЗ
Объём	~1,5 млн адресных объектов и ~30 млн домов
Режим поставки	bootstrap-снапшот (ГБ-масштаб) + ежедневные дельты с tombstone
Поиск	префикс-поиск по нормализованному названию + нормализация цепочкой регион → город → улица → дом

dataAsOf — у каждого ответа API HTTP и gRPC — один контракт

Зачем он вам

Стандартизация и подсказки адресов у внешних сервисов — оплата за каждый запрос (до 0,20 ₽ за адрес): при приёме клиентов, доставке и наполнении CRM набегает быстрее, чем обходится подписка. Безлимитный модуль окупается примерно от 450 тыс. адресов в месяц при цене 90 000 ₽.

Один контур с остальными проверками (или сам по себе): адреса приходят тем же подписанным каналом обновлений, подсказки и нормализация отвечают за миллисекунды, свежесть среза видна в dataAsOf.

Охват — адресные объекты и дома в административной иерархии ГАР (регион → город → улица → дом); комнаты и владения — вне модуля. Нормализованный адрес — каноническая запись ГАР, а не юридически значимое подтверждение места жительства.

Пример запроса и ответа

Значения в примерах — синтетические, вымышленные (как в демо-терминале); форма ответа совпадает с реальным API коробки — HTTP и gRPC одним контрактом.

Подсказки при вводе

Запрос

curl -s -G 'http://127.0.0.1:8080/api/v1/address/suggest' --data-urlencode 'query=Синт'

Ответ

{
  "dataAsOf": "2026-10-04 09:00 МСК",
  "suggestions": [
    { "id": "addr-0", "kind": "object", "name": "Синтетическая", "typeShort": "обл", "chain": [] },
    { "id": "addr-1", "kind": "object", "name": "Синтягорск", "typeShort": "г",
      "chain": [ "обл Синтетическая" ] },
    { "id": "addr-s0", "kind": "object", "name": "Синтезная", "typeShort": "ул",
      "chain": [ "обл Синтетическая", "г Синтягорск" ] }
  ]
}

Нормализация адреса

Запрос

curl -s -G 'http://127.0.0.1:8080/api/v1/address/normalize' --data-urlencode 'query=Синтетическая, Синтягорск, Синтезная, 7к2'

Ответ

{
  "status": "matched",
  "dataAsOf": "2026-10-04 09:00 МСК",
  "address": {
    "chain": [ "обл Синтетическая", "г Синтягорск", "ул Синтезная" ],
    "house": "7к2",
    "postalCode": "100007"
  }
}