Query CPD user summaries

  • Updated on Feb 19, 2026
  • Published on Oct 27, 2025
  • 1 minute(s) read
Prev Next
Get
/cpdUserLogSummaries

Retrieves CPD summaries (up to 1,000 per page) for users with filtering by date and user IDs

Security
HTTP
Type basic

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

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

  • 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

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.

FlowClient Credentials
Token URLhttps://public.api.learn.link/oauth2/token/:tenantId
Query parameters
userIds
string

Comma-separated list of user IDs to filter by

Example5c9de5c64a6b1c37a58e393c,5cadda57f4a0f40010af03de
page
integer

Page number for pagination

Minimum1.0
Default1
Example1
perPage
integer

Number of records per page

Minimum1.0
Maximum1000.0
Default100
Example5
entryDateFrom
stringRequired

Filter entries after this date (format YYYY-MM-DDThh:mm:ss)

Example2020-11-17T09:50:00
entryDateTo
stringRequired

Filter entries before this date (format YYYY-MM-DDThh:mm:ss)

Example2021-11-17T09:51:00
Responses
200

Successful response

{
  "pagination": {
    "totalResults": 2,
    "totalPages": 1,
    "page": 1,
    "perPage": 100
  },
  "results": [
    {
      "userId": "5c9de5c64a6b1c37a58e393c",
      "durationMinutes": 360
    },
    {
      "userId": "5cadda57f4a0f40010af03de",
      "durationMinutes": 620
    }
  ]
}
Expand All
object
pagination
object (Pagination)

Details of the pagination

totalResults
integer

Total number of results matching the query

Example48
totalPages
integer

Total number of pages available

Example3
page
integer

Current page number

Minimum1.0
Default1
Example1
perPage
integer

Number of results per page

Minimum1.0
Maximum1000.0
Default100
Example20
results
Array of object (CPDUserSummary)
object
userId
string

ID of the user this summary is for

Pattern^[0-9a-fA-F]{24}$
Example5c9de5c64a6b1c37a58e393c
durationMinutes
integer

Total CPD minutes logged by the user within the specified time period

Minimum0.0
Example360