v1

latestOpenAPI 3.0.12026-07-24283883639.5 KB

User

Get a Specific User

This endpoint retrieves a specific user. You can retrieve a user by specifying the ID as a path parameter or specifying an identifier as a query string URL parameter. For example, https://api.betatest.degreed.com/api/v2/users/<email_value>?identifier=email <br><br>For Global Admin Tool Organizations, if the user belongs to a Tenant Organization, then the X-Degreed-Organization-Code header must be provided. <h3>Required Scope</h3>users:read or users:write

get/api/v2/users/{id}

Path parameters

idstring required

The ID of the user to retrieve.

Query parameters

identifierstring

Example:<email_value>?identifier=email

How to identify the user. The identifier can be id (default), employee-id, or email and must be used as a query string URL parameter.

Headers

X-Degreed-Organization-Codestring

Example:tenant_organization_code

For Global Admin Tool Organizations, include this header in your request to retrieve a user from the tenant organization. You must provide your organization code as the value. Contact your Degreed technical partner if you are unsure what your organization code is.

Response

Success