Получить сведения о паспортах

Скопировать прямую ссылку на статью

Дата актуализации 24.02.2026

Назначение	Получение сведений всех документов гражданина по идентификатору пользователя (oid) и типу документа (doc_type)
Тип запроса	GET
Path	/{host}/digital/api/public/{version}/pso/{oid}/doc/PASSPORT_HISTORY
Авторизация	Указать в заголовке запроса поле «Authorization» с полученным маркером доступа, содержащим информацию о действующем согласии
Параметры запроса	– version – версия API (текущая версия v2). Для запроса типа документа PASSPORT_HISTORY рекомендуется использовать вторую версию (v2) API; – oid – уникальный идентификатор пользователя; – doc_type – PASSPORT_HISTORY; - test={id}, где id – порядковый номер тестового ответа для конкретного сведения.
Модель документа	История выданных паспортов

Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/v2/pso/1077132659/doc/PASSPORT_HISTORY

--header 'Authorization: Bearer token'

Примеры ответов для версии v2:

Пример ответа- запрос досье в МВД

{
"oid":"2080151820",
"requestId":"110001223009"
}

Пример ответа - нет согласия пользователя

{
"code":"ESIA-036710",
"message":"Согласие не найдено"
}

Пример ответа - паспортное досье (только действующий паспорт)

[
{
"oid":"2080151820",
"id":"ac71e6ce-ba63-49f1-b72c-45e2b0d53cf0",
"version":1,
"createdOn":1741874179293,
"updatedOn":1741874179293,
"receiptDocDate":1741874179293,
"relevance":"actual",
"status":"verified_by_request",
"lastName":"Туров",
"firstName":"Евгений",
"middleName":"Александрович",
"birthDate":"07.08.1987",
"departmentDoc":"Главное управление по вопросам миграции МВД России",
"history":[
{
"passportType":"rf_passport",
"series":"2561",
"number":"231663",
"issueDate":"02.06.2024",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"issueId":"661212",
"passportStatus":"valid"
}
],
"type":"PASSPORT_HISTORY"
}
]

Пример ответа - паспортное досье

[
{
"oid":"2080151820",
"id":"ec55b6c5-04bf-4266-b817-4190da17d458",
"version":1,
"createdOn":1741871310933,
"updatedOn":1741871310933,
"receiptDocDate":1741871310933,
"relevance":"actual",
"status":"verified_by_request",
"lastName":"Туров",
"firstName":"Евгений",
"middleName":"Александрович",
"birthDate":"07.08.1987",
"departmentDoc":"Главное управление по вопросам миграции МВД России",
"history":[
{
"passportType":"rf_passport",
"series":"2561",
"number":"231663",
"issueDate":"02.06.2024",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"issueId":"661212",
"passportStatus":"valid"
},
{
"passportType":"rf_passport",
"series":"4580",
"number":"609666",
"issueDate":"20.02.2020",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"issueId":"382004",
"passportStatus":"invalid",
"invalidityReason":"replaced"
},
{
"passportType":"rf_passport",
"series":"4530",
"number":"609675",
"issueDate":"20.02.2019",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"issueId":"382004",
"passportStatus":"noInformation"
},
{
"passportType":"frgn_pass",
"series":"99",
"number":"1234122",
"issueDate":"02.03.2010",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"issueId":"382004",
"passportStatus":"invalid",
"invalidityReason":"inSearch"
},
{
"passportType":"frgn_pass",
"series":"22",
"number":"1234567",
"issueDate":"02.03.2009",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"issueId":"382004",
"passportStatus":"invalid",
"invalidityReason":"destroyed"
},
{
"passportType":"frgn_pass",
"series":"21",
"number":"1234333",
"issueDate":"02.03.2008",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"passportStatus":"invalid",
"invalidityReason":"ownerDeath"
},
{
"passportType":"ussr_passport",
"series":"VVVVVVVVVV-ЛО",
"number":"123456",
"issueDate":"02.03.1980",
"issuedBy":"Главное управление по вопросам миграции МВД России",
"passportStatus":"noInformation"
}
],
"type":"PASSPORT_HISTORY"
}
]

Пример ответа - ошибка

[
{
"oid":"2080151820",
"id":"d0355828-ef06-495f-8530-a16da62c2207",
"version":1,
"createdOn":1741873851702,
"updatedOn":1741873851702,
"receiptDocDate":1741873851702,
"relevance":"actual",
"status":"verified_by_request",
"lastName":"Туров",
"firstName":"Евгений",
"middleName":"Александрович",
"birthDate":"07.08.1987",
"departmentDoc":"Главное управление по вопросам миграции МВД России",
"error":"DocHistoryError",
"errorUpdatedOn":1741873851702,
"type":"PASSPORT_HISTORY"
}
]

Тестирование

Также для сведений реализована возможность получения предопределенных, тестовых ответов, «заглушек» в интеграционной среде ЕСИА и ЦП (https://esia-portal1.test.gosuslugi.ru/). Для того, чтобы при вызове метода возвращались тестовые данные, необходимо дополнительно указывать в запросе параметр test={id}, где id – порядковый номер тестового ответа для конкретного сведения

Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/v2/pso/1077132659/doc/PASSPORT_HISTORY?test=1'

--header 'Authorization: Bearer token'

Параметр	Описание
?test=1	Три вида паспорта с различными причинами недействительности

, чтобы оставить комментарий к статье