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

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

<figure><img src="https://1997706258-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGd7t8Xm9EFLYborr9A%2Fuploads%2Fgit-blob-43bd1ffa183c47388c8e948b90ea1af388271d48%2Fpassport_registration.png?alt=media" 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://docs.dbrain.io/servisy/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`

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

{% hint style="success" %}
**address\_division — string**
{% endhint %}

Поведение по умолчанию: `address_division=administrative` — при обращении в [API сервиса Dadata.ru](https://dadata.ru/api/clean/address/#response) адрес возвращается только в административном делении, в поле `address`. В случае с `address_division=municipal` дополнительновозвращается значение в поле `address_gar`. Подробнее о разнице в делениях читайте в документации сервиса [Dadata.ru](https://confluence.hflabs.ru/pages/viewpage.action?pageId=1326056589).

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dbrain.io/servisy/izvlechenie-dannykh/pasport-propiska.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.