Get Completions for a Specific User

get

https://api.betatest.degreed.com/api/v2/users/{id}/completions

This endpoint retrieves all completions 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>/completions?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, completions:read or completions:write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The ID of the user to retrieve.

Query Params

limit

int32

Defaults to 100

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

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>/completions?identifier=email

filter[added_after]

date

required

Filter criteria that returns completions added after this date. Format yyyy-mm-dd.

filter[added_before]

date

required

Filter criteria that returns completions added before this date. Format yyyy-mm-dd.

filter[content_id]

integer

Filter criteria that only returns content with this ID.

filter[content_type]

string

Filter criteria that only returns content with this content type. Acceptable values are course, event, video, assessment, podcast, book, or task.

Headers

X-Degreed-Organization-Code

string

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

200Success