Получить сведения о паспортах через REST API с идентификатором согласия

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

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

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

Curl

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

--header 'Authorization: Bearer token'

Примеры ответов:

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

{
"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"
}
]

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

{
"oid": "2080151820",
"statusDoc": "NO_CONSENT"
}

Пример ответа - ошибка 403 - заблокирован доступ к REST API

HTTP Status Code: 403 Forbiden
{
"message": "Доступ к данным ограничен. Необходимо снять ограничение доступа для коммерческой организации со стороны МЦ"
}

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

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

Curl

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

--header 'Authorization: Bearer token'

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

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