Get Required Learning for a Specific User

get

https://api.betatest.degreed.com/api/v2/users/{id}/required-learning

This endpoint retrieves all required learning for 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>/required-learning?identifier=email

For Global Admin Tool Organizations, if the user belongs to a Tenant Organization, then the X-Degreed-Organization-Code header must be provided.

Required Scope

users:read, users:write, required_learning:read or required_learning:write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Pagination
The API takes a snapshot of the paginated set of required learning items at the time of the first request. Paging through required learning items goes through this fixed set of items. The snapshotted set becomes obsolete when a request has not been made for 2 minutes.

Path Params

string

required

The ID of the user to retrieve.

Query Params

limit

int32

Defaults to 100

The maximum number of required learning items to display per page. A maximum of 1000 is allowed.

string

Retrieves the next batch of required learning items. This value expires after 2 minutes if a request has not been made during that time.

identifier

string

Defaults to id

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. For example, https://api.betatest.degreed.com/api/v2/users/<email_value>/required-learning?identifier=email

Headers

X-Degreed-Organization-Code

string

For Global Admin Tool Organizations, include this header in your request to retrieve required learning items for the specified user in 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

Pagination

200Success