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

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

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

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

Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/commercial/v1/pso/1077132659?permissionId=0125451145;
--header 'Authorization: Bearer token'

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

В случае запроса данных со всеми допустимыми областями доступа (scope):

Пример ответа со всеми данными

{

"oid": "1077000658",

"firstName": "Иван",

"middleName": "Иванович",

"lastName": "Иванов",

"snils": "000-000-033 03",

"inn": "467267451126",

"gender": "M",

"birthDate": "24.02.1970",

"birthPlace": "гор. Москва",

"citizenship": "RUS",

"email": "1239@yandex.ru",

"mobilePhone": "+7(000)0000000",

"registrationAddress" : {

"addressStr": "г. Москва, пр-кт. Мира",

"region": "Москва",

"flat": "264",

"countryId": "RUS",

"house": "124",

"frame": "9",

"zipCode": "129164",

"street": "Мира",

"fiasCode": "e3d6b244-41b8-453f-9f4b-a02e452faecb"

"temporaryAddress": {

"addressStr": "г. Москва, пр-кт. Мира",

"region": "Москва",

"flat": "264",

"countryId": "RUS",

"house": "124",

"frame": "9",

"zipCode": "129164",

"street": "Мира",

"fiasCode": "e3d6b244-41b8-453f-9f4b-a02e452faecb"

"homeAddress": {

"addressStr": "г. Москва, пр-кт. Мира",

"region": "Москва",

"flat": "264",

"countryId": "RUS",

"house": "124",

"frame": "9",

"zipCode": "129164",

"street": "Мира",

"fiasCode": "e3d6b244-41b8-453f-9f4b-a02e452faecb"

"trusted": true

}

В случае запроса данных с конкретной областью доступа (scope):

ФИО пользователя

{

"oid": "1077000658",

"firstName": "Иван",

"middleName": "Иванович",

"lastName": "Иванов",

"trusted": true

}

СНИЛС

{
"oid": "1077000658",
"snils": "000-000-033 03",
"trusted": true
}

Номер мобильного телефона

{
"oid": "1077000658",
"mobilePhone": "+7(000)0000000",
"trusted": true
}

Место рождения

{
"oid": "1077000658",
"birthPlace": "гор. Москва"
}

Дата рождения

{

"oid": "1077000658",

"birthDate": "24.02.1970",

"trusted": true

}

Пол пользователя

{

"oid": "1077000658",

"gender": "M",

"trusted": true

}

Адреса

{
"oid": "1077000658",
"registrationAddress": {
"addressStr": "г. Москва, пр-кт. Мира",
"region": "Москва",
"flat": "264",
"countryId": "RUS",
"house": "124",
"frame": "9",
"zipCode": "129164",
"street": "Мира",
"fiasCode": "e3d6b244-41b8-453f-9f4b-a02e452faecb"
},
"temporaryAddress": {
"addressStr": "г. Москва, пр-кт. Мира",
"region": "Москва",
"flat": "264",
"countryId": "RUS",
"house": "124",
"frame": "9",
"zipCode": "129164",
"street": "Мира",
"fiasCode": "e3d6b244-41b8-453f-9f4b-a02e452faecb"
},
"homeAddress": {
"addressStr": "г. Москва, пр-кт. Мира",
"region": "Москва",
"flat": "264",
"countryId": "RUS",
"house": "124",
"frame": "9",
"zipCode": "129164",
"street": "Мира",
"fiasCode": "e3d6b244-41b8-453f-9f4b-a02e452faecb"
},
"trusted": true
}

ИНН

{

"oid": "1077000658",

"inn": "467267451126",

"trusted": true

}

Адрес электронной почты

{

"oid": "1077000658",

"email": "1239@yandex.ru",

"trusted": true

}

Пример ответа - ошибка 401

{

"code": "ESIA-005013",

"message": "SecurityErrorEnum.expiredToken"

}

Пример ответа - ошибка 403 - в токене отсутствуют скоупы для получения сведений

{

"code": "ESIA-005029",

"message": "SecurityErrorEnum.scopeNotAllowed"

}

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

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

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

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

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