ym88659208ym87991671
Шаг 3. Запрос получение данных пользователя | Документация для разработчиков

Шаг 3. Запрос получения данных пользователя

Обновлено 7 апреля 2025

На Схеме взаимодействия обозначен как «17. Запрос ПД клиента».

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

Для успешного выполнения запроса необходимо использовать сертификат, полученый при регистрации приложения на портале Сбер ID , по нашей документации.

Back-end партнера инициирует запрос в back-end банка на получение профиля клиента. Тип запроса - GET.

Пример запроса:

Пример

curl --request GET \
--url https://oauth-ift.sber.ru/ru/prod/sberbankid/v2.1/userinfo \
--header 'authorization: Bearer DC3641EC-A0C1-F61A-B2DE-A331C0B2E20F' \
--header 'x-introspect-rquid:L4hE5nH3wB5lC6sP0bO7bA666yM5bH5h'

Описание полей  запроса на получение профиля клиента

№   п/пНаименование поляЗаголовок/полеОписаниеОбязательность поля 
1AuthorizationЗаголовокПолученный ранее access_token, см. Ответ на запрос access token и Id token.В начало необходимо добавить «Bearer», например: Bearer DC3641EC-A0C1-F61A-B2DE-A331C0B2E20FДа
2x-introspect-rquidЗаголовокУникальный идентификатор сообщения, «length=32 и pattern=([0-9][a-f][A-F])32)», переданный во входящем сообщении. Необходим для журналирования входящих вызовов и удобства разбора инцидентов.Чтобы обеспечить уникальность, можно использовать стандартные библиотеки и классы для генерации UUID/GUID(https://ru.wikipedia.org/wiki/UUID ), убрав из результата разделители «-».Да

Параметры ответа

При успешной проверке запроса, Банк формирует ответ, содержащий данные клиента, и возвращает его в ответе типа HTTP 200 OK. Ниже приведен пример сообщения.

Важно!

  • Если по клиенту в банке нет запрошенных данных или клиент запретил передачу этих данных, то данный скоуп в ответе будет отсутствовать

  • При запросе неразрешенных данному партнеру скоупов будет возвращена ошибка invalid_scope

Ответ содержит JSON-объект, в котором находятся запрошенные данные пользователя.

{
  "sub": "2db933f8184f1f525a338b04e7ac1218a432f",
  "family_name": "Фамилия",
  "given_name": "Имя",
  "middle_name": "Отчество",
  "birthdate": "01.01.2001",
  "identification": {
    "series": "9999",
    "number": "112233",
    "issued_by": "Кем выдан",
    "issued_date": "2001-01-01",
    "code": "000-000"
  },
  "inn": {
    "number": "771400000000"
  },
  "snils": {
    "number": "999 999 999 99"
  },
  "driving_license": {
    "number": "9999999999"
  },
  "priority_doc": {
    "series": "9999",
    "number": "112233",
    "issued_by": "Кем выдан",
    "issued_date": "2001-01-01",
    "code": "000-000",
    "type": 1
  },
  "international_passport": {
    "series": "Z9999",
    "number": "999999",
    "issued_by": "Кем выдан",
    "issued_date": "2001-01-01",
    "planned_end_date": "2001-01-01"
  },
  "sts": {
    "number": "12345678"
  },
  "phone_number": "+7 (903) 1111111",
  "email": "qwer@qwer.ru",
  "gender": 1,
  "is_company_employee": false,
  "citizenship": {
    "country_code": "Код страны",
    "country_name": "Наименование страны"
  },
  "place_of_birth": "Место рождения",
  "address": {
    "full_address": "Полный адрес",
    "fias_code": "Идентификационный код объекта по ФИАС",
    "post_index": "Почтовый индекс",
    "country": "Страна",
    "region": "Регион",
    "district": "Район",
    "city": "Город",
    "settlement": "Населенный пункт",
    "street": "Название улицы",
    "house": "Дом",
    "building": "Строение",
    "bulk": "Корпус",
    "apartment": "Квартира"
  },
  "address_of_actual_residence": {
    "full_address": "Полный адрес",
    "fias_code": "Идентификационный код объекта по ФИАС",
    "post_index": "Почтовый индекс",
    "country": "Страна",
    "region": "Регион",
    "district": "Район",
    "city": "Город",
    "settlement": "Населенный пункт",
    "street": "Название улицы",
    "house": "Дом",
    "building": "Строение",
    "bulk": "Корпус",
    "apartment": "Квартира"
  },
  "address_reg": {
    "full_address": "Полный адрес",
    "fias_code": "Идентификационный код объекта по ФИАС",
    "post_index": "Почтовый индекс",
    "country": "Страна",
    "region": "Регион",
    "district": "Район",
    "city": "Город",
    "settlement": "Населенный пункт",
    "street": "Название улицы",
    "house": "Дом",
    "building": "Строение",
    "bulk": "Корпус",
    "apartment": "Квартира"
  },
  "work_address": {
    "full_address": "Полный адрес",
    "fias_code": "Идентификационный код объекта по ФИАС",
    "post_index": "Почтовый индекс",
    "country": "Страна",
    "region": "Регион",
    "district": "Район",
    "city": "Город",
    "settlement": "Населенный пункт",
    "street": "Название улицы",
    "house": "Дом",
    "building": "Строение",
    "bulk": "Корпус",
    "apartment": "Квартира"
  },
  "delivery_address": {
    "full_address": "Полный адрес",
    "fias_code": "Идентификационный код объекта по ФИАС",
    "post_index": "Почтовый индекс",
    "country": "Страна",
    "region": "Регион",
    "district": "Район",
    "city": "Город",
    "settlement": "Населенный пункт",
    "street": "Название улицы",
    "house": "Дом",
    "building": "Строение",
    "bulk": "Корпус",
    "apartment": "Квартира"
  },
  "previous_family_name": "Предыдущая фамилия",
  "previous_given_name": "Предыдущее имя",
  "previous_middle_name": "Предыдущее отчество",
  "job_title": "Должность",
  "place_of_work": "Наименование организации (место работы)",
  "marital_status": {
    "code": 1,
    "description": "Описание"
  },
  "education": {
    "code": 1,
    "description": "Описание"
  },
  "is_self_employed": false,
  "previous_identification": {
    "series": "9999",
    "number": "112233",
    "issued_by": "Кем выдан",
    "issued_date": "2001-01-01",
    "code": "000-000"
  }
}

Описание полей данных пользователя

ScopeНаименование поля в ответеОписаниеПример
Пакет Light
openid (обязательно)subНеизменный уникальный идентификатор клиента, передаваемый внешним потребителям."sub":"e327493e-979a-461f-9ca5-edfab9d6fbab"
emailemailАдрес электронной почты"email":“personal@mail.ru”
mobilephone_numberНомер телефона"phone_number":"+7 (000) 000000”
Пакет Standart
birthdatebirthdateДата рождения (формат ГГГГ-ММ-ДД) "birthdate":"0000-00-00"
namefamily_name, given_name, middle_nameФамилия Имя Отчество

"family_name":"Фамилия"

"given_name":"Имя"

"middle_name":"Отчество"

gendergenderПол: 1 – мужчина; 2 – женщина;"gender":1,
Пакет Professional
maindocidentificationПолные данные паспорта: серия,номер,орган, выдавший паспорт,дата выдачи паспорта (формат ГГГГ-ММ-ДД),код подразделения

"identification":{

"series":"00 00",

"number":"000000",

"issued_by":"Орган выдавший документ",

"issued_date":"0000-00-00",

"code":"000-000"

}

inninnИНН номер

"inn":{

"number":"0000000"

}

snilssnilsСНИЛС номер

"snils":{

"number":"0000000"

}

driving_licensedriving_licenseНомер водительского удостоверения

"driving_license":{

"number":"111111"

}

international_passportinternational_passportЗаграничный паспорт гражданина РФ:серия документа (формат 00 00),номер документа(формат 000000),кем выдан, дата выдачи (формат ГГГГ-ММ-ДД),дата окончания (формат ГГГГ-ММ-ДД),имя,фамилия

"international_passport":{

"series":"777",

"number":"333",

"issued_by":"рога и копыта",

"issued_date":"1981-01-01",

"planned_end_date":"1999-02-01",

"name":"name",

"surname":"surname"

}

priority_docpriority_docДанные документа, удостоверяющего личность:тип,серия документа (формат 00 00),номер документа (формат 000000),кем выдан, дата выдачи (формат ГГГГ-ММ-ДД),код. Выводится один документ в соответствии со списком приоритетов:Паспорт РФ, Загранпаспорт гражданина РФ, Военный билет, Паспорт моряка, Временное удостоверение, Паспорт иностранного граданина, Вид на жительство иностранного гражданина.
Доступные типы документов:
  • 17 - Паспортгражданина РФ
  • 18 - Загранпаспортгражданина РФ
  • 7 - Военный билетвоеннослужащего
  • 21 - Удостоверениеличности моряка
  • 14 - Временное удостоверение личности гражданина РФ
  • 10 - Паспорт иностранного гражданина
  • 75 - Вид на жительство в РФ иностранного гражданина

"priority_doc":{

"type":17,

"series":"777",

"number":"333",

"issued_by":"рога и копыта",

"issued_date":"1981-01-01",

"code":"adasd"

}

citizenshipcitizenshipГражданство: последняя по актуальности страна гражданства (наименование на русском языке) и ее код (ОКСМ, буквенное обозначение – Альфа-3)

"citizenship":{

"country_code":"countryCode",

"country_name":"countryName"

}

place_of_birthplace_of_birthМесто рождения – город рождения клиента (текстовое поле, не кодируется)"place_of_birth":”Nsk”
address_regaddress_regАдрес регистрации: полный адрес, код ФИАС, почтовый индекс, страна, регион, район, город, поселение, улица, дом, строение, корпус, квартира

"address_reg":{

"full_address":"fullAddress",

"fias_code":"fiasCode",

"post_index":"postIndex",

"country":"country",

"region":"region",

"district":"district",

"city":"city",

"settlement":"settlement",

"street":"street",

"house":"house",

"building":"building",

"bulk":"bulk",

"apartment":"apartment"

}

work_addresswork_addressРабочий адрес: полный адрес, код ФИАС, почтовый индекс, страна, регион, район, город, поселение, улица, дом, строение, корпус, квартира

"work_address":{

"full_address":"fullAddress",

"fias_code":"fiasCode",

"post_index":"postIndex",

"country":"country",

"region":"region",

"district":"district",

"city":"city",

"settlement":"settlement",

"street":"street",

"house":"house",

"building":"building",

"bulk":"bulk",

"apartment":"apartment"

}

address_of_actual_residenceaddress_of_actual_residenceАдрес места жительства/доставки: полный адрес,код ФИАС,почтовый индекс,страна,регион,район,город,поселение,улица,дом,строение,корпус,квартира

"address_of_actual_residence":{

"full_address":"fullAddress",

"fias_code":"fiasCode",

"post_index":"postIndex",

"country":"country",

"region":"region",

"district":"district",

"city":"city",

"settlement":"settlement",

"street":"street",

"house":"house",

"building":"building",

"bulk":"bulk",

"apartment":"apartment"

}

delivery_addressdelivery_addressАдрес для доставки: полный адрес,код ФИАС,почтовый индекс,страна,регион,район,город,поселение,улица,дом,строение,корпус,квартира

"delivery_address":{

"full_address":"fullAddress",

"fias_code":"fiasCode",

"post_index":"postIndex",

"country":"country",

"region":"region",

"district":"district",

"city":"city",

"settlement":"settlement",

"street":"street",

"house":"house",

"building":"building",

"bulk":"bulk",

"apartment":"apartment"

}

is_company_employeeis_company_employee Признак сотрудника ПАО "Сбербанк""is_company_employee":true,
stsstsНомер СТС

"sts":{

"number":"00 00 00000"

}

previous_identificationprevious_identificationРеквизиты ранее выданного паспорта гражданина РФ: Серия документа, Номер документа, Кем выдан, Дата выдачи

"previous_identification":{

"series":"00 00",

"number":"000 000",

"issued_by":"Орган выдавший документ",

"issued_date":"0000-00-00"

}

previous_nameprevious_family_name, previous_given_name, previous_middle_nameПредыдущие фамилия, имя, отчество

"previous_family_name":"Фамилия"

"previous_given_name":"Имя"

"previous_middle_name":"Отчество"

educationeducationСведения об образовании:Код + описание,начальное,среднее,среднее специальное,высшее,магистратура и пр.

"education":{

"code":"1",

"description":"начальное"

}

place_of_workplace_of_workНаименование организации(место работы)"place_of_work": "место работы",
job_titlejob_titleНаименование занимаемой должности"job_title": "должность"
marital_statusmarital_statusСемейное положение:Код + описание,холост,женат,разведен,вдовец/ вдова,раздельное проживание,гражданский брак и пр.

"marital_status":{

"code":"1",

"description":"холост"

}

is_self_employedis_self_employedПризнак самозанятого"is_self_employed":true
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.