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

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

<figure><img src="https://content.gitbook.com/content/7DoBBoXJ21Tl2UDe24h0/blobs/4U9DdgKtjv5QvZJi8RdP/passport_registration.png" alt="" width="563"><figcaption><p>Паспорт РФ, разворот «Место жительства» с печатным штампом о регистрации</p></figcaption></figure>

{% hint style="success" %}
Тип документа в API:`passport_registration`
{% endhint %}

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

* `passport_registration_handwritten` — рукописный штамп о регистрации;
* `passport_registration_deregistered` — штамп о снятии с регистрации.

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

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

{% hint style="danger" %}
Перед началом работы изучите общее описание сервиса извлечения данных в разделе [«Извлечение данных»](https://doc.dbrain.io/dbrain-official/izvlechenie-dannykh). Ниже мы перечислили лишь уникальные параметры для прописки
{% endhint %}

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

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

{% hint style="success" %}
**normalization\_fias — boolean**
{% endhint %}

Поведение по умолчанию: `normalization_fias=true` — сервис нормализует поле «Адрес». Для этого сервис обращается к [API сервиса Dadata.ru](https://dadata.ru/api/clean/address/#response) и возвращает адрес в [формате ФИАС](https://ru.wikipedia.org/wiki/%D0%A4%D0%B5%D0%B4%D0%B5%D1%80%D0%B0%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F_%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D0%B0%D1%8F_%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%BD%D0%B0%D1%8F_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%B0#%D0%A1%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0_%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%B0_%D0%BF%D0%BE_%D0%A4%D0%98%D0%90%D0%A1). Это повышает точность извлечения поля «Адрес». Поэтому сервис выдаёт корректный результат даже в ситуациях, когда часть адреса нечитабельна.

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

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

{% hint style="info" %}
Если сервис Dbrain развёрнут локально, он может обращаться за нормализацией адреса к локальному сервису Dadata. Для этого укажите адрес в параметре URL\_DADATA в .env
{% endhint %}

{% hint style="success" %}
Помимо извлечения данных сервис Dbrain умеет:

* [Верифицировать результаты извлечения данных в онлайн-режиме с помощью обученных людей](https://doc.dbrain.io/dbrain-official/manual-recognition)
  {% endhint %}