LinkedIn Learning Activity Reports API

APIs to retrieve learning activity reports including completions, views, and logins

Documentation GitHub OpenAPI

Business capability

Learning & Development Management BC-300.40

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/learningActivityReports Get LinkedIn Learning activity reports · LinkedIn Get Learning Activity Reports #

Ask an LLM

“How many courses did our learners complete last month?”

“Can I aggregate learning activity by individual or by content?”

Tell an agent

Get learning activity from {startedAt} over {duration} {unit} grouped by {primary}.

Report learning activity for content source {contentSource} since {startedAt}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/linkedin:linkedin-learning-activity-reports-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: LinkedIn Learning Activity Reports API
  description: 'The LinkedIn Learning APIs enable access to Learning Content and Learning Activity Reports. This API provides learning activity reports including course completions, seconds of content viewed, and learner logins. Activity data can be aggregated by account, group, individual, or content.

    Access to LinkedIn Learning APIs is available to members of the Partner Program and organizations that have purchased LinkedIn Learning site licenses.'
  version: 1.0.0
  contact:
    name: LinkedIn Learning API Support
    url: https://docs.microsoft.com/en-us/linkedin/learning/overview/
servers:
- url: https://api.linkedin.com
  description: LinkedIn Production API Server
security:
- OAuth2Auth:
  - r_lms_learning
tags:
- name: Learning Activity Reports
  description: APIs to retrieve learning activity reports including completions, views, and logins
paths:
  /v2/learningActivityReports:
    get:
      tags:
      - Learning Activity Reports
      summary: LinkedIn Get Learning Activity Reports
      description: Retrieve LinkedIn Learning activity reports including course completions, seconds of content viewed, and learner logins. Data can be aggregated by account, group, individual, or content.
      operationId: getLearningActivityReports
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: ''
      parameters:
      - name: referer
        in: header
        required: false
        schema:
          type: string
        description: Referrer URN for the request
        example: urn:li:enterpriseAccount:999
      - name: q
        in: query
        required: true
        schema:
          type: string
          enum:
          - criteria
        description: Query type
        example: criteria
      - name: count
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 10
        description: Number of results to return
        example: 1
      - name: startedAt
        in: query
        required: true
        schema:
          type: integer
          format: int64
        description: Start timestamp in milliseconds since epoch
        example: 1627267600000
      - name: timeOffset.unit
        in: query
        required: true
        schema:
          type: string
          enum:
          - DAY
          - WEEK
          - MONTH
        description: Time offset unit
        example: DAY
      - name: timeOffset.duration
        in: query
        required: true
        schema:
          type: integer
          minimum: 1
        description: Time offset duration
        example: 7
      - name: aggregationCriteria.primary
        in: query
        required: true
        schema:
          type: string
          enum:
          - ACCOUNT
          - GROUP
          - INDIVIDUAL
          - CONTENT
        description: Primary aggregation criteria
        example: ACCOUNT
      - name: contentSource
        in: query
        required: false
        schema:
          type: string
          enum:
          - ALL_SOURCES
          - LINKEDIN_LEARNING
          - CUSTOM_CONTENT
        description: Source of learning content to include
        example: ALL_SOURCES
      - name: locale.language
        in: query
        required: false
        schema:
          type: string
        description: Locale language code
        example: en
      - name: start
        in: query
        required: false
        schema:
          type: integer
          default: 0
        description: Starting index for pagination
        example: 0
      responses:
        '200':
          description: Successfully retrieved learning activity reports
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LearningActivityReportResponse'
              examples:
                SuccessResponse:
                  $ref: '#/components/examples/LearningActivityReportResponseExample'
        '400':
          description: Bad request - invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                BadRequestExample:
                  value:
                    status: 400
                    message: Invalid aggregation criteria
                    code: INVALID_AGGREGATION_CRITERIA
        '401':
          description: Unauthorized - invalid or missing access token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                UnauthorizedExample:
                  value:
                    status: 401
                    message: Invalid access token
                    code: UNAUTHORIZED
        '403':
          description: Forbidden - insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ForbiddenExample:
                  value:
                    status: 403
                    message: Access to LinkedIn Learning APIs requires Partner Program membership
                    code: FORBIDDEN
        '429':
          description: Too many requests - rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                RateLimitExample:
                  value:
                    status: 429
                    message: Rate limit exceeded
                    code: RATE_LIMIT_EXCEEDED
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
          example: 400
        message:
          type: string
          description: Error message
          example: Invalid request parameters
        code:
          type: string
          description: Error code
          example: INVALID_PARAMS
    LearnerDetails:
      type: object
      properties:
        entity:
          $ref: '#/components/schemas/LearnerEntity'
    LearningActivityReportResponse:
      type: object
      properties:
        elements:
          type: array
          items:
            $ref: '#/components/schemas/LearningActivityReport'
        paging:
          $ref: '#/components/schemas/Paging'
    LearningActivityReport:
      type: object
      properties:
        latestDataAt:
          type: integer
          format: int64
          description: Timestamp of the latest data included in this report
          example: 1632207540000
        activities:
          type: array
          items:
            $ref: '#/components/schemas/LearningActivity'
        learnerDetails:
          $ref: '#/components/schemas/LearnerDetails'
    LearnerEntity:
      type: object
      properties:
        accountUrn:
          type: string
          description: URN of the enterprise account
          example: urn:li:enterpriseAccount:999
        groupUrn:
          type: string
          description: URN of the learner group (if grouped by group)
          example: urn:li:learnerGroup:456
        learnerUrn:
          type: string
          description: URN of the individual learner (if grouped by individual)
          example: urn:li:learner:789
        contentUrn:
          type: string
          description: URN of the content (if grouped by content)
          example: urn:li:learningCourse:123
    Paging:
      type: object
      properties:
        total:
          type: integer
          description: Total number of results
          example: 1
        count:
          type: integer
          description: Number of results in this response
          example: 1
        start:
          type: integer
          description: Starting index
          example: 0
        links:
          type: array
          items:
            $ref: '#/components/schemas/PagingLink'
    PagingLink:
      type: object
      properties:
        rel:
          type: string
          example: next
        href:
          type: string
          example: /v2/learningActivityReports?aggregationCriteria.primary=ACCOUNT&count=1&q=criteria&start=1&startedAt=1627267600000&timeOffset.duration=7&timeOffset.unit=DAY
        type:
          type: string
          example: application/json
    LearningActivity:
      type: object
      properties:
        engagementType:
          type: string
          enum:
          - LOGINS
          - VIEWS
          - SECONDS_VIEWED
          - COMPLETIONS
          description: Type of engagement activity
          example: LOGINS
        engagementValue:
          type: integer
          description: Numeric value of the engagement
          example: 88
        engagementMetricQualifier:
          type: string
          enum:
          - UNIQUE
          - TOTAL
          description: Whether the metric is unique or total count
          example: UNIQUE
        assetType:
          type: string
          enum:
          - VIDEO
          - ARTICLE
          - AUDIO
          - BOOK
          - LEARNING_COLLECTION
          - COURSE
          - DOCUMENT
          - EVENT
          - LEARNING_PATH
          description: Type of learning asset
          example: VIDEO
        firstEngagedAt:
          type: integer
          format: int64
          description: Timestamp of first engagement
          example: 1627267600000
        lastEngagedAt:
          type: integer
          format: int64
          description: Timestamp of last engagement
          example: 1627354000000
      required:
      - engagementType
      - engagementValue
      - engagementMetricQualifier
  examples:
    LearningActivityReportResponseExample:
      summary: Learning activity report aggregated by account
      value:
        elements:
        - latestDataAt: 1632207540000
          activities:
          - engagementType: LOGINS
            engagementValue: 88
            engagementMetricQualifier: UNIQUE
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: VIEWS
            engagementValue: 12
            engagementMetricQualifier: UNIQUE
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: SECONDS_VIEWED
            engagementValue: 2505
            engagementMetricQualifier: TOTAL
            assetType: VIDEO
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: VIEWS
            engagementValue: 0
            engagementMetricQualifier: TOTAL
            assetType: ARTICLE
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: COMPLETIONS
            engagementValue: 0
            engagementMetricQualifier: TOTAL
            assetType: ARTICLE
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: VIEWS
            engagementValue: 16
            engagementMetricQualifier: TOTAL
            assetType: COURSE
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: COMPLETIONS
            engagementValue: 1
            engagementMetricQualifier: TOTAL
            assetType: COURSE
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: VIEWS
            engagementValue: 2
            engagementMetricQualifier: TOTAL
            assetType: LEARNING_PATH
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: COMPLETIONS
            engagementValue: 0
            engagementMetricQualifier: TOTAL
            assetType: LEARNING_PATH
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: VIEWS
            engagementValue: 66
            engagementMetricQualifier: TOTAL
            assetType: VIDEO
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          - engagementType: COMPLETIONS
            engagementValue: 22
            engagementMetricQualifier: TOTAL
            assetType: VIDEO
            firstEngagedAt: 1627267600000
            lastEngagedAt: 1627354000000
          learnerDetails:
            entity:
              accountUrn: urn:li:enterpriseAccount:999
        paging:
          total: 1
          count: 1
          start: 0
          links:
          - rel: next
            href: /v2/learningActivityReports?aggregationCriteria.primary=ACCOUNT&count=1&q=criteria&start=1&startedAt=1627267600000&timeOffset.duration=7&timeOffset.unit=DAY
            type: application/json
  securitySchemes:
    OAuth2Auth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.linkedin.com/oauth/v2/authorization
          tokenUrl: https://www.linkedin.com/oauth/v2/accessToken
          scopes:
            r_lms_learning: Read learning management data