Войти
Назад

Получить сведения об ЭТК

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

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


Назначение

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

Тип запроса

GET

Path

{host}/digital/api/public/{version}/pso/{oid}/doc/ELECTRONIC_WORKBOOK

Авторизация

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

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

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

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

– doc_type – ELECTRONIC_WORKBOOK;

– test={id}, где id – порядковый номер тестового ответа для конкретного сведения. 

Модель документа Сведения об ЭТК
 Примеры base64  Скачать

Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/v1/pso/2080039927/doc/ELECTRONIC_WORKBOOK'

--header 'Authorization: Bearer token'

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


Пример ответа - Запрос сведений в СФР

{
   "oid":"2080039927",
   "requestId":"110001233313"
}

Пример ответа с данными
{
    "oid": "2080039927",
    "id": "0c0918cb-a1d0-4e05-84b6-b71a3778ac3b",
    "apiVersion": "v1",
    "version": 1,
    "createdOn": 1764784441783,
    "updatedOn": 1764784441783,
    "receiptDocDate": 1764784441783,
    "validateDateDoc": 1626448277503,
    "relevance": "actual",
    "status": "verified_by_request",
    "xmlFile": {
        "file": "Выписка в XML, закодированная в формате BASE64"},
    "pdfFile": {
        "file": "Выписка в PDF, закодированная в формате BASE64"},
    "statement": {
        "continuationDate": "20.10.2020"
    },
    "events": [
        {
            "organization": {
                "orgName": "АКЦИОНЕРНОЕ ОБЩЕСТВО ",
                "regNumber": "060-050-009942",
                "inn": "5047053920",
                "kpp": "504701001"
            },
            "uuid": "40efe480-eab2-4da8-9e95-b8d24b657c7f",
            "date": "11.11.2019",
            "type": 1,
            "position": "Аналитик",
            "isPartTimeJob": false,
            "division": "Отдел аналитики Департамента архитектуры и аналитики ",
            "reason": [
                {
                    "document": "Приказ",
                    "date": "11.11.2019",
                    "number": "1954"
                }
            ]
        },
        {
            "organization": {
                "orgName": "АКЦИОНЕРНОЕ ОБЩЕСТВО",
                "regNumber": "060-050-009942",
                "inn": "5047053920",
                "kpp": "504701001"
            },
            "uuid": "2e77e05c-9102-4d5b-bb5b-ed961e61566a",
            "date": "02.07.2020",
            "type": 2,
            "position": "Аналитик",
            "isPartTimeJob": false,
            "division": "Отдел аналитики и проектирования ",
            "reason": [
                {
                    "document": "Приказ",
                    "date": "02.07.2020",
                    "number": "649/67"
                }
            ]
        }
    ],
    "type": "ELECTRONIC_WORKBOOK"
}

Пример ответа - Ошибка при запросе в СФР

{
   "code":"ESIA-031100",
   "message":"Запрос был завершен с ошибкой или отменен"
}


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

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

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/v1/pso/2181502158/doc/ELECTRONIC_WORKBOOK?test=1'

--header 'Authorization: Bearer token'

Параметр Описание
 ?test=1  ЭТК по гражданину с записями в электронной трудовой книжке за последние два года

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