---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - en/
  - ru/
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/id/doc/en/llms.txt

# About

[Yandex ID](https://yandex.com/support/id/index.html) — is a single account to access all Yandex services. API Yandex ID you can set up user authorization via the [OAuth 2.0 protocol](https://yandex.com/dev/id/doc/en/concepts/ya-oauth-intro.md) on your website or in your mobile app.

API Yandex ID makes interaction with your website easier:
* Users can authorize with their Yandex account. They won't have to create a new account and fill out additional forms. 
* Developers will be able to identify the user and use information from their Yandex account to personalize the app's content and interface. Permissions granted to each app are limited to those that were specified by the developer when [registering](https://yandex.com/dev/id/doc/en/register-client.md) the app.
* You can use the [instant authorization technology](https://yandex.com/dev/id/doc/en/suggest-description.md) for a website or the [SDK Yandex ID library](https://yandex.com/dev/id/doc/en/mobileauthsdk/about.md) for mobile devices to implement the login system.

See [OAuth implementation at Yandex](https://yandex.com/dev/id/doc/en/concepts/ya-oauth-intro.md) for information about the basic OAuth concepts and the features specific to Yandex.

{% note tip %}

To make your service more trustworthy to users, [verify your account via Gosuslugi](https://yandex.com/dev/id/doc/en/confirm-account.md).

{% endnote %}

## How it works {#how-it-works}

1. When authorizing in your app, the user chooses logging in with their Yandex account.

{% cut "Screenshot" %}

![](./_assets/log-in.png =360x)

{% endcut %}

1. The app [connected to API Yandex ID](https://yandex.com/dev/id/doc/en/how-to.md) redirects the user to Yandex OAuth and requests access to their Yandex account data. The user confirms logging in with their Yandex account and allows access to their data.

{% cut "Screenshot" %}

![](./_assets/confirm-data-2.png =360x)

{% endcut %}

1. The app [obtains an OAuth token](https://yandex.com/dev/id/doc/en/access.md) with permissions enabling it to access API Yandex ID. Then a request can be sent to API Yandex ID to retrieve the following user data:
   * Login, first name, last name, and gender.
   * User's profile picture.
   * Email address.
   * Phone number.
   * Date of birth.

1. The app sends a request to API Yandex ID specifying the OAuth token it received and gets the [unique user ID and their data](https://yandex.com/dev/id/doc/en/user-information.md).

1. The app authorizes the user using the settings and content linked to the ID it received. This way, Yandex users get an account in your app without creating a new account.

## Useful links {#useful-links}

* [OAuth implementation at Yandex](https://yandex.com/dev/id/doc/en/concepts/ya-oauth-intro.md)
* [Connecting to API Yandex ID](https://yandex.com/dev/id/doc/en/how-to.md)
* [SDK Yandex ID for mobile apps](https://yandex.com/dev/id/doc/en/mobileauthsdk/about.md)