Page cover image

Паспорт

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

Актуальная форма паспорта выдаётся с 1 октября 1997 года. С 1 июля 2011 года в паспорте заполняются нижние две строки с машиночитаемыми записями (МЧЗ). Сервис извлекает данные как из визуальных полей, так и из МЧЗ. При выборе между ними, сервис ориентируется на контрольные суммы в МЧЗ и читабельность данных визуальных полей.

Пример документа из Wikipedia

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

Поле
Название в API
Формат поля

Серия и номер

series_and_number

4 цифры, пробел, 6 цифр

Имя

first_name

Русский алфавит

Фамилия

surname

Русский алфавит

Отчество

other_names

Русский алфавит

Пол

sex

муж. или жен.

Дата рождения

date_of_birth

дд.мм.гггг

Место рождения

place_of_birth

Русский алфавит

Дата выдачи

date_of_issue

дд.мм.гггг

Код подразделения

subdivision_code

3 цифры, тире, 3 цифры

Паспорт выдан

issuing_authority

Русский алфавит

МЧЗ, строка 1

mrz_1

Латинский алфавит, цифры, <>

МЧЗ, строка 2

mrz_2

Латинский алфавит, цифры, <>

Номер разворота

page_number

Номера страниц главного разворота паспорта. Всегда возвращает 2-3

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

Нормализация поля «Паспорт выдан»

use_internal_api — boolean

Поведение по умолчанию: use_internal_api=true — сервис нормализует поле «Паспорт выдан». Для этого он использует расширенную версию справочника соответствий кода подразделения и места выдачи. Так мы повышаем точность извлечения поля «Паспорт выдан». Поэтому сервис выдаёт корректный результат даже в ситуациях, когда поле полностью нечитабельно.

В крайне редких случаях нормализация может приводить к неточному соответствию результатов распознавания поля «Паспорт выдан» и фактического текста в паспорте. Например, вместо ОТДЕЛОМ УФМС РОССИИ ПО Г. МОСКВЕ ПО РАЙОНУ ЗЮЗИНО сервис может вернуть ОТДЕЛОМ УФМС РОССИИ ПО ГОРОДУ МОСКВЕ ПО РАЙОНУ ЗЮЗИНО.

Мы не рекомендуем, но если вы всё же хотите отключить нормализацию поля «Паспорт выдан», передайте параметр use_internal_api=false