> For the complete documentation index, see [llms.txt](https://docs.npck.kz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.npck.kz/servisy-coid/servis-biometricheskoi-autentifikacii/poluchenie-personalnykh-dannykh-iz-gosudarstvennoi-bazy.md).

# Получение персональных данных из государственной базы

## Scopes

Услуга, предоставляемая ЦОИД, определяется значениями, указанными в параметре `scopes` при формировании запроса на получение URL-адреса для перенаправления пользователя в ЦОИД.

***

### Получение персональных данных

| Scope                  | Описание                                            |
| ---------------------- | --------------------------------------------------- |
| `iin`                  | Доступ к ИИН пользователя                           |
| `full_name`            | Доступ к ФИО пользователя                           |
| `first_name`           | Доступ к имени пользователя                         |
| `last_name`            | Доступ к фамилии пользователя                       |
| `middle_name`          | Доступ к отчеству пользователя                      |
| `date_of_birth`        | Доступ к дате рождения пользователя                 |
| `place_of_birth`       | Доступ к месту рождения пользователя                |
| `gender`               | Доступ к полу пользователя                          |
| `nationality`          | Доступ к национальности пользователя                |
| `citizenship`          | Доступ к гражданству пользователя                   |
| `registration_address` | Доступ к адресу регистрации пользователя            |
| `document_number`      | Доступ к номеру документа, удостоверяющего личность |
| `document_type`        | Доступ к типу документа, удостоверяющего личность   |
| `document_issue_date`  | Доступ к дате выдачи документа                      |
| `document_expiry_date` | Доступ к дате истечения срока действия документа    |
| `document_issue_place` | Доступ к информации о том, кем был выдан документ   |

{% hint style="info" %}
Описание вложенных объектов:

* `place_of_birth` - см. [Структура объекта «place\_of\_birth»](/servisy-coid/servis-dvukhfaktornoi-autentifikacii-lichnosti-klienta-finid/opisanie-obektov.md#ref130980979)
* `gender`, `nationality`, `document_issue_place`, `document_type` - см. [Структура объектов «country», «district», «region», «gender», «nationality», «document\_issue\_place», «document\_type»](/servisy-coid/servis-biometricheskoi-autentifikacii/opisanie-obektov.md)
* `registration_address` - см. Структура объекта [«registration\_address»](https://docs.npck.kz/servisy-coid/servis-biometricheskoi-autentifikacii/pages/KpbVMLTHvKRa02TsXVS3#id-3.-struktura-obekta-registration_address-adres-registracii)
  {% endhint %}

***

### Верификация физического лица

| Scope    | Описание                                                                                  |
| -------- | ----------------------------------------------------------------------------------------- |
| `openid` | Только верификация личности пользователя без предоставления доступа к персональным данным |

{% hint style="info" %}
Если необходима только верификация личности — в параметре `scopes` должно быть указано только значение `openid`.
{% endhint %}

***

### Подписание документов ЭЦП

| Scope       | Описание                                                                                                                   |
| ----------- | -------------------------------------------------------------------------------------------------------------------------- |
| `esign`     | Подписание документов ЭЦП. Может использоваться совместно со scopes для персональных данных и верификации физического лица |
| `antifraud` | Доступ к информации о том, не числится ли пользователь в реестре лиц, причастных к мошенническим операциям                 |

→ Подробнее о подписании: [Сервис управления облачной ЭЦП Esign](/servisy-coid/servis-upravleniya-oblachnoi-ecp-esign.md)

***

### Проверка юридического лица

| Scope          | Описание                                                       |
| -------------- | -------------------------------------------------------------- |
| `legal_entity` | Проверка юридического лица на первого руководителя организации |

{% hint style="warning" %}
Для использования `legal_entity` необходимо дополнительно передать в запросе параметр `legalEntityScopeData` с БИН организации:

```json
{
  "scopes": ["legal_entity"],
  "legalEntityScopeData": {
    "bin": "БИН должен соответствовать проверяемой организации"
  }
}
```

{% endhint %}

→ Описание объектов: [Описание объектов](/servisy-coid/servis-biometricheskoi-autentifikacii/opisanie-obektov.md)