Войти
Назад

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

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

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


Назначение

Получение сведений всех документов гражданина по идентификатору пользователя (oid) и типу документа (doc_type)

Тип запроса

GET

Path

/digital/api/public/commercial/{version}/pso/{oid}/doc/FRGN_PASS

Авторизация

Указать в заголовке запроса поле «Authorization» с полученным маркером доступа, содержащим информацию о действующем согласии

Параметры запроса в path

– version – версия API (текущая версия – v1);

– oid – уникальный идентификатор пользователя;

– doc_type – FRGN_PASS

Параметры запроса в query – permissionId -  идентификатор выданного согласия пользователя ЕСИА для внешней ИС
Модель документа Заграничный паспорт

Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/commercial/v1/pso/2181494500/doc/FRGN_PASS?permissionId=125478596'

--header 'Authorization: Bearer token'

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


Пример ответа с данными
[
    {
        "oid": "2181494500",
        "id": "3696882",
        "receiptDocDate": 1763636551000,
        "validateDateDoc": 1763636551000,
        "relevance": "actual",
        "status": "verified_by_validate",
        "departmentDoc": "Главное управление по вопросам миграции МВД России",
        "series": "04",
        "number": "7824677",
        "issuedBy": "Отделом УФМС Кировского р-на гор. Тула",
        "issueDate": "20.11.2020",
        "expiryDate": "20.11.2030",
        "latinFirstName": "KONSTANTIN",
        "latinLastName": "FEDOSEEV",
        "type": "FRGN_PASS"
    }
]

Пример ответа - ошибка 401
{
    "code": "ESIA-005013",
    "message": "SecurityErrorEnum.expiredToken"
}

Пример ответа - ошибка 403 - в токене отсутствуют скоупы для получения сведений
{
    "code": "ESIA-005029",
    "message": "SecurityErrorEnum.scopeNotAllowed"
}

Пример ответа - ошибка 404 - Данных нет

HTTP Status Code: 404 Not Found

Пример ответа - нет согласия пользователя
{
    "oid": "2181494500",
    "statusDoc": "NO_CONSENT"
}

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