Дата актуализации 24.04.2026
|
Назначение |
Получение сведений всех документов гражданина по идентификатору пользователя (oid) и типу документа (doc_type) |
|
Тип запроса |
GET |
|
Path |
/{host}/digital/api/public/commercial/{version}/pso/{oid}/doc/RF_PASSPORT |
|
Авторизация |
Указать в заголовке запроса поле «Authorization» с полученным маркером доступа, содержащим информацию о действующем согласии |
|
Параметры запроса в path |
– version – версия API (текущая версия – v1); – oid – уникальный идентификатор пользователя; – doc_type – RF_PASSPORT |
| Параметры запроса в query | - permissionId - идентификатор выданного согласия пользователя ЕСИА для внешней ИС |
|
Модель документа |
Curl
|
--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/commercial/v1/pso/1077132659/doc/RF_PASSPORT?permissionId=0125451145' --header 'Authorization: Bearer token' |
Примеры ответов:
Пример ответа с данными
|
[ { "oid": "1077132659", "id": "358750", "receiptDocDate": 1756296886000, "validateDateDoc": 1756296886000, "relevance": "actual", "status": "verified_by_validate", "departmentDoc": "МВД России", "series": "3123", "number": "331232", "issueId": "123332", "issuedBy": "123", "issueDate": "17.11.2021", "type": "RF_PASSPORT" } ] |
Пример ответа - ошибка 401
|
{ "code": "ESIA-005013", "message": "SecurityErrorEnum.expiredToken" } |
Пример ответа - ошибка 403 - в токене отсутствуют скоупы для получения сведений
|
{ "code": "ESIA-005029", "message": "SecurityErrorEnum.scopeNotAllowed" } |
Пример ответа - ошибка 404 - Данных нет
|
HTTP Status Code: 404 Not Found |
Пример ответа - нет согласия пользователя
|
{ "oid": "1077132659", "statusDoc": "NO_CONSENT" } |
Пример ответа - ошибка 403 - заблокирован доступ к REST API
|
HTTP Status Code: 403 Forbiden { "message": "Доступ к данным ограничен. Необходимо снять ограничение доступа для коммерческой организации со стороны МЦ" } |