Returns paginated goal completions for the user identified by the user-id or user-ref header. Completion date filters are optional; when omitted, all completed goals for the user are returned page by page. There is no human session on this path; the caller must supply the owner id or external reference so the read can be scoped downstream.
HTTP Basic authentication using your Tenant ID and API secret.
- Username is the Tenant ID (i.e.
eu-west-2_AbcdEfghI) - Password is the API secret you would have received.
You can also authenticate using OAuth 2.0 client credentials (oauth2 security scheme) instead of Basic auth.
OAuth 2.0 client credentials authentication.
Use the following token endpoints (replace :tenantId with your Tenant ID):
Public API access tokens
- Staging:
https://public.api.learnstaging.link/oauth2/token/:tenantId - Production:
https://public.api.learn.link/oauth2/token/:tenantId - Staging MEA:
https://public.api.meastaging.learn.tech/oauth2/token/:tenantId - Production MEA:
https://public.api.mea.learn.tech/oauth2/token/:tenantId
- Staging:
Webhooks access tokens
- Staging:
https://user.api.learnstaging.link/oauth2/token/:tenantId - Production:
https://user.api.learn.link/oauth2/token/:tenantId - Staging MEA:
https://user.api.meastaging.learn.tech/oauth2/token/:tenantId - Production MEA:
https://user.api.mea.learn.tech/oauth2/token/:tenantId
- Staging:
All access tokens must be sent using the Authorization: Bearer <access_token> header.
Scopes
For API access (non-webhooks), the following scopes are available:
api/all– Full read and write access to the API.api/read– Read-only access to the API.api/write– Write access to the API.
For webhooks, the following scopes are available:
api/webhooks– Access to webhook functionality.api/all– Full read and write access to the API, including webhooks.
Tokens must include appropriate scopes for the endpoints you wish to call.
MongoDB id of the user whose goal completions are requested. Required unless user-ref is supplied.
External reference of the user whose goal completions are requested. Required unless user-id is supplied.
ISO8601 start of the completion date range (inclusive)
ISO8601 end of the completion date range (exclusive; must be on or after start when both are provided)
Comma-separated list of skills to filter by
Field to sort completions by
Sort direction
Set the current page of results
Used in combination with the page parameter to page through the data, will be prioritised over limit.
Allowed values: 1–1000
Set the number of items to retrieve per page
Goal completions for the user in the requested period
Details of the pagination
Total number of results matching the query
Total number of pages available
Current page number
Number of results per page
A user goal (personal or assigned).
The goal ID
The goal owner's user ID
Unauthorized
Unauthorized
Forbidden
Forbidden
Unprocessable Content
Unprocessable Content
Internal Server Error
Internal Server Error