Паспорт: прописка

Извлекаем данные из паспорта гражданина РФ: место жительства, стр. 5-12

На страницах 5-12 паспорта ФМС проставляет отметки о регистрации и снятии с регистрации по месту жительства. ФМС ставит штампы в хронологическом порядке. Сервис находит самый свежий штамп на изображении и извлекает из него данные. Остальные штампы игнорируются.

Паспорт РФ, разворот «Место жительства» с печатным штампом о регистрации

Тип документа в API:passport_registration

Если последний штамп отличается от машинопечатной отметки о регистрации, сервис изменит doc_type в ответе:

• passport_registration_handwritten — рукописный штамп о регистрации;

• passport_registration_deregistered — штамп о снятии с регистрации.

Перечень извлекаемых полей

Название в API	Описание
address	Адрес
address_gar	Адрес по ГАР
apartment	Квартира
area	Район в регионе
area_fias_id	ФИАС-код района в регионе
area_type	Тип района в регионе (сокращенный)
area_type_full	Тип района в регионе
area_with_type	Район в регионе с типом
beltway_distance	Расстояние от кольцевой в километрах
beltway_hit	Внутри кольцевой?
block	Корпус/строение
block_type	Тип корпуса/строения (сокращенный)
block_type_full	Тип корпуса/строения
capital_marker	Признак центра района или региона: 1 — центр района (Московская обл, Одинцовский р-н, г Одинцово) 2 — центр региона (Новосибирская обл, г Новосибирск) 3 — центр района и региона (Томская обл, г Томск) 4 — центральный район региона (Тюменская обл, Тюменский р-н) 0 — ничего из перечисленного (Московская обл, г Балашиха)
city_area	Административный округ (только для Москвы)
city_district	Адм. район города
city_district_fias_id	ФИАС-код адм. района города
city_district_kladr_id	Не заполняется
city_district_type	Тип адм. района города (сокращенный)
city_district_type_full	Тип адм. района города
city_district_with_type	Адм. район города с типом
city_fias_id	ФИАС-код города
city_type	Тип города (сокращенный)
city_type_full	Тип города
city_with_type	Город с типом
country	Страна
country_iso_code	ISO-код страны (двухсимвольный)
date	Дата регистрации/снятия с регистрации
divisions	Зарезервировано
entrance	Не заполняется
federal_district	Федеральный округ
fias_actuality_state	Признак актуальности адреса в ФИАС 0 — актуальный 1–50 — переименован 51 — переподчинен 99 — удален
fias_code	Зарезервировано
fias_id	ФИАС-код (он же код ГАР) адреса для России. Идентификатор OpenStreetMap для Беларуси, Казахстана и Узбекистана. Для остальных стран — идентификатор объекта в базе GeoNames.
fias_level	Уровень детализации, до которого адрес найден в ФИАС (ГАР): 0 — страна 1 — регион 3 — район 4 — город 5 — район города 6 — населенный пункт 7 — улица 8 — дом 9 — квартира или комната 65 — планировочная структура 75 — земельный участок -1 — иностранный или пустой
flat_area	Площадь квартиры
flat_cadnum	Кадастровый номер квартиры
flat_fias_id	ФИАС-код квартиры
flat_price	Рыночная стоимость квартиры
flat_type	Тип квартиры (сокращенный)
flat_type_full	Тип квартиры
floor	Не заполняется
geo_lat	Координаты: широта
geo_lon	Координаты: долгота
geoname_id	Идентификатор объекта в базе GeoNames. Для российских адресов не заполняется.
house	Дом
house_cadnum	Кадастровый номер дома
house_fias_id	ФИАС-код дома
house_type	Тип дома (сокращенный)
house_type_full	Тип дома
issuing_authority	Название подразделения
kladr_area_code	КЛАДР-код района
kladr_city_code	КЛАДР-код города
kladr_code	КЛАДР-код адреса
kladr_house_code	КЛАДР-код дома
kladr_region_code	КЛАДР-код региона
kladr_settlement_code	КЛАДР-код населенного пункта
kladr_street_code	КЛАДР-код улицы
locality	Город
okato	Код ОКАТО
oktmo	Код ОКТМО
page_number	Номер разворота
postal_box	Абонентский ящик
postal_code	Индекс
qc	Не заполняется
qc_complete	Не заполняется
qc_geo	Код точности координат: 0 — точные координаты 1 — ближайший дом 2 — улица 3 — населенный пункт 4 — город 5 — координаты не определены
qc_house	Не заполняется
region	Регион
region_fias_id	ФИАС-код региона
region_iso_code	ISO-код региона
region_type	Тип региона (сокращенный)
region_type_full	Тип региона
region_with_type	Регион с типом
series_number	Серия и номер
settlement	Населенный пункт
settlement_fias_id	ФИАС-код нас. пункта
settlement_type	Тип населенного пункта (сокращенный)
settlement_type_full	Тип населенного пункта
settlement_with_type	Населенный пункт с типом
source	Не заполняется
square_meter_price	Рыночная стоимость м²
stead	номер земельного участка
stead_cadnum	Кадастровый номер земельного участка
stead_fias_id	ФИАС-код земельного участка
stead_type	«уч»
stead_type_full	«участок»
street	Улица
street_fias_id	ФИАС-код улицы
street_type	Тип улицы (сокращенный)
street_type_full	Тип улицы
street_without_type	Улица без типа
subdivision_code	Код подразделения
tax_office	Код ИФНС для физических лиц
tax_office_legal	Код ИФНС для организаций
timezone	Часовой пояс
unparsed_parts	Не заполняется
unrestricted_value	Адрес одной строкой (полный, с индексом)

Перед началом работы изучите общее описание сервиса извлечения данных в разделе «Извлечение данных». Ниже мы перечислили лишь уникальные параметры для прописки

Параметры запроса к API

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

normalization_fias — boolean

Поведение по умолчанию: normalization_fias=true — сервис нормализует поле «Адрес». Для этого сервис обращается к API сервиса Dadata.ru и возвращает адрес в формате ФИАС. Это повышает точность извлечения поля «Адрес». Поэтому сервис выдаёт корректный результат даже в ситуациях, когда часть адреса нечитабельна.

Нормализация приводит неструктурированный адрес к общепринятому формату, который можно сопоставлять с адресами из других источников. При этом может отсутствовать побуквенное соответствие адресу из штампа.

Мы не рекомендуем, но! Если вы хотите отключить нормализацию поля «Адрес», передайте параметр normalization_fias=false

Если сервис Dbrain развёрнут локально, он может обращаться за нормализацией адреса к локальному сервису Dadata. Для этого укажите адрес в параметре URL_DADATA в .env

Помимо извлечения данных сервис Dbrain умеет:

• Верифицировать результаты извлечения данных в онлайн-режиме с помощью обученных людей