Assessment Progress API

The Assessment Progress API provides assessment attempt data across your organization, including attempt status, results, and timestamps.

Endpoint

POST https://api.udacity.com/api/public/api/v1/assessment-progress/graphql

Required scope

COMPANY:<companyId>

Your API token must have a COMPANY scope with your company ID as the scope key.

Overview

The Assessment Progress API returns per-attempt records for assessments taken by learners in your organization. Results are company-scoped and can optionally be filtered by learning plan.

DataDescription
Attempt identityUser ID, assessment ID, attempt ID
Status & resultAssessment status (e.g., completed, in progress) and result (e.g., passed, failed)
ReportAssessment report data (when available)
TimestampsWhen the record was created and last updated

Example

query {
  assessmentProgress(input: {
    filter: { assessmentResult: ["passed"] }
    orderBy: UPDATED_AT
    order: DESC
    first: 10
  }) {
    totalCount
    pageInfo { hasNextPage endCursor }
    edges {
      node {
        userId
        assessmentId
        attemptId
        assessmentStatus
        assessmentResult
        createdAt
        updatedAt
      }
    }
  }
}

Next

  • Queries — Full query reference with all filters and sorting options
  • Types — All types, inputs, and enums