Assessment Progress API — Queries

Retrieve assessment progress records for the authenticated company.

Endpoint

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

`assessmentProgress`

Required scope: COMPANY:<companyId>

Input fields

filterAssessmentProgressFilter

Filter criteria.

orderByAssessmentProgressOrderBy

Field to sort results by.

orderSortOrder

Sort direction (ASC or DESC).

firstInt

Maximum results to return (default 50).

afterString

Cursor for forward pagination.

Filter fields

assessmentId[ID!]

Filter by assessment IDs.

assessmentStatus[String!]

Filter by status (e.g., completed, in_progress).

assessmentResult[String!]

Filter by result (e.g., passed, failed).

userId[ID!]

Filter by user IDs.

learningPlanId[ID!]

Filter by learning plan IDs.

Returns: AssessmentProgressConnection!

Signature

type Query {
  assessmentProgress(input: AssessmentProgressInput!): AssessmentProgressConnection!
}

Query

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

Response

{
  "data": {
    "assessmentProgress": {
      "totalCount": 156,
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "eyJpZCI6IjEwIn0="
      },
      "edges": [
        {
          "node": {
            "userId": "8a386eac-5a18-4229-88a4-add7f1ee600f",
            "assessmentId": "87fac66e-1cca-483b-899b-fae24a89e4f2",
            "attemptId": "a1b2c3d4-5678-90ef-abcd-1234567890ab",
            "assessmentStatus": "completed",
            "assessmentResult": "passed",
            "assessmentReport": null,
            "createdAt": "2026-03-01T10:00:00Z",
            "updatedAt": "2026-03-01T10:45:00Z"
          }
        }
      ]
    }
  }
}