Gradebook API

The Gradebook API provides read access to assessment results and assessment line items generated automatically when your application submits Caliper events via the Events API. Results are created when GradeEvent and AssessmentItemEvent.Completed events are processed. All endpoints require Authorization: Bearer <token>.

Base prefix: https://api.alpha-1edtech.ai/gradebook/1.0

---

GET /gradebook/1.0/assessment-results

Returns a paginated list of assessment results. Each result represents a student's score on a specific assessment.

Filter examples:

• filter=subject='Math' — results for Math only
• filter=appName='my-learning-app' — results from a specific app
• filter=scoreDate>='2026-02-01' AND scoreDate<='2026-02-28' — results in a date range
• filter=subject='Math' AND appName='my-learning-app' — combine filters

Scope: gradebook.readonly

Query params

Name	Description	Required
limit	Maximum records per page (default 100, max 1000)	no
offset	Number of records to skip (default 0)	no
filter	OneRoster filter expression. Operators: =, !=, >, >=, <, <=, ~, @. Combine with AND / OR.	no
sort	Field to sort by	no
orderBy	Sort direction: asc or desc	no
fields	Comma-separated list of fields to include	no

Response

200 OK — { "assessmentResults": [...], "offset": 0, "limit": 100, "total": N }

Key result fields: sourcedId, score, scoreDate, scoreStatus, student, assessmentLineItem, subject, lessonType, accuracy, totalQuestions, correctQuestions, xp, passedTest.

Example

curl "https://api.alpha-1edtech.ai/gradebook/1.0/assessment-results?filter=subject%3D'Math'" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

---

GET /gradebook/1.0/assessment-results/:sourcedId

Returns a single assessment result by its sourcedId.

Scope: gradebook.readonly

Path params

Name	Description
sourcedId	Assessment result UUID

Response

200 OK — Assessment result object. 404 if not found.

Key fields include: sourcedId, score, scoreDate, scoreStatus, student, assessmentLineItem, subject, grade, lessonType, accuracy, totalQuestions, correctQuestions, xp, passedTest, caliperSourcedId.

Example

curl "https://api.alpha-1edtech.ai/gradebook/1.0/assessment-results/RESULT_UUID" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

---

GET /gradebook/1.0/assessment-line-items

Returns a paginated list of assessment line items. Each line item defines an assessment that students can take.

Filter examples:

• filter=subject='Math' — line items for Math
• filter=source='caliper' — line items created from Caliper events
• filter=subject='Math' AND source='caliper' — combine filters

Scope: gradebook.readonly

Query params

Same pagination and filter params as GET /assessment-results above.

Response

200 OK — { "assessmentLineItems": [...], "offset": 0, "limit": 100, "total": N }

Key line item fields: sourcedId, title, description, assignDate, dueDate, resultValueMin, resultValueMax, class, course, unit, lesson, subject, lessonType, source.

Example

curl "https://api.alpha-1edtech.ai/gradebook/1.0/assessment-line-items?filter=source%3D'caliper'" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

---

GET /gradebook/1.0/assessment-line-items/:sourcedId

Returns a single assessment line item by its sourcedId.

Scope: gradebook.readonly

Path params

Name	Description
sourcedId	Assessment line item UUID

Response

200 OK — Assessment line item object. 404 if not found.

Example

curl "https://api.alpha-1edtech.ai/gradebook/1.0/assessment-line-items/LINE_ITEM_UUID" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

---

GET /gradebook/1.0/line-items

Partner-friendly alias for GET /gradebook/1.0/assessment-line-items. Returns the same paginated list of line items (assessments students can take).

Filter examples:

• filter=subject='Math' — line items for Math
• filter=source='caliper' — line items created from Caliper events
• filter=subject='Math' AND source='caliper' — combine filters

Scope: gradebook.readonly

Query params

Same pagination and filter params as GET /assessment-line-items above.

Response

200 OK — { "assessmentLineItems": [...], "offset": 0, "limit": 100, "total": N }

Example

curl "https://api.alpha-1edtech.ai/gradebook/1.0/line-items" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

---

GET /gradebook/1.0/line-items/:sourcedId

Partner-friendly alias for GET /gradebook/1.0/assessment-line-items/{sourcedId}.

Scope: gradebook.readonly

Path params

Name	Description
sourcedId	Line item UUID

Response

200 OK — Assessment line item object. 404 if not found.

Example

curl "https://api.alpha-1edtech.ai/gradebook/1.0/line-items/LINE_ITEM_UUID" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"