Get All Required Learning Items

get

https://api.betatest.degreed.com/api/v2/required-learning

This endpoint retrieves all required learning items for the current organization. The required learning endpoint requires a start and end date, with a maximum range of 7 days.

Note: Information on completed items is not retrieved unless you use the filter[status] URL parameter.

For Global Admin Tool Organizations, if the X-Degreed-Organization-Code header is included, the endpoint will return required learning items for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization.

Required Scope

required_learning:read

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

filter[start_date]

date

required

Filter criteria that returns learning items that were created, or modified on this date or later. Format yyyy-mm-dd.

filter[end_date]

date

required

Filter criteria that returns learning items that were created, or modified before this date. Format yyyy-mm-dd.

filter[status]

string

Filter criteria that returns learning items by status. Status options include Pending, Queued, Dismissed, and Complete.

Note: To retrieve information on completed items, you must use this filter.

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.

limit

int32

Defaults to 100

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

Headers

X-Degreed-Organization-Code

string

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

200Success