Войти

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

Дата актуализации 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": "Доступ к данным ограничен. Необходимо снять ограничение доступа для коммерческой организации со стороны МЦ"
}
Авторизуйтесь, чтобы оставить комментарий к статье