Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Identity Hub
  • Access management
  • Pricing policy
  • Terraform reference
    • Authentication
      • Overview
        • Overview
          • Overview
          • Get
          • List
          • Create
          • Update
          • Delete
          • SetOwnPassword
          • SetOthersPassword
          • Suspend
          • Reactivate
          • GeneratePassword
          • GetSelfPasswordMetadata
          • ConvertToExternal
          • SetPasswordHash
          • ResolveExternalIds
  • Audit Trails events
  • Release notes
  • Yandex Identity Hub Sync Agent release notes

In this article:

  • gRPC request
  • GetUserRequest
  • User
  1. API reference
  2. gRPC
  3. Identity Provider API
  4. User
  5. Get

Identity Provider API, gRPC: UserService.Get

Written by
Yandex Cloud
Updated at February 24, 2026
  • gRPC request
  • GetUserRequest
  • User

Returns the specified user.

To get the list of available users, make a List request.

gRPC requestgRPC request

rpc Get (GetUserRequest) returns (User)

GetUserRequestGetUserRequest

{
  "user_id": "string"
}

Request to get a user by ID.

Field

Description

user_id

string

Required field. ID of the user to return.

The maximum string length in characters is 50.

UserUser

{
  "id": "string",
  "userpool_id": "string",
  "status": "Status",
  "username": "string",
  "full_name": "string",
  "given_name": "string",
  "family_name": "string",
  "email": "string",
  "phone_number": "string",
  "created_at": "google.protobuf.Timestamp",
  "updated_at": "google.protobuf.Timestamp",
  "external_id": "string",
  "company_name": "string",
  "department": "string",
  "job_title": "string",
  "employee_id": "string"
}

A user in the Identity Provider system.

Users are created within a userpool and can authenticate to access cloud resources.
Each user has a unique identifier, credentials, and profile information.

Field

Description

id

string

Unique identifier of the user.
This ID is generated automatically when the user is created.

userpool_id

string

ID of the userpool this user belongs to.
To get the userpool ID, make a UserpoolService.List request.

status

enum Status

Current status of the user.
Determines whether the user can authenticate and access the system.

  • CREATING: The user is in the process of being created.
  • ACTIVE: The user is active and can authenticate.
    Active users have full access to the system according to their permissions.
  • SUSPENDED: The user is suspended and cannot authenticate.
    Suspended users retain their data but cannot access the system.
  • DELETING: The user is in the process of being deleted.
    This is a transitional state before the user is completely removed from the system.

username

string

Username used for authentication.
Usually in the format of an email address.

full_name

string

User's full name (display name).
This is typically shown in the UI and used for identification purposes.

given_name

string

User's first name.
Part of the user's profile information.

family_name

string

User's last name.
Part of the user's profile information.

email

string

User's email address.

phone_number

string

User's phone number.

created_at

google.protobuf.Timestamp

Timestamp when the user was created.

updated_at

google.protobuf.Timestamp

Timestamp when the user was last updated.

external_id

string

External identifier for federation with external identity systems.
This ID can be used to link this user with an account in an external system.

company_name

string

User's company name.

department

string

User's department.

job_title

string

User's job title.

employee_id

string

User's employee ID

Was the article helpful?

Previous
Overview
Next
List
© 2026 Direct Cursus Technology L.L.C.