Check if a student is eligible to self-request a test-out
Checks whether a student can self-request an assessment to test out of their current grade level for a given subject.
The endpoint performs the following checks in order:
- Verifies the student has an active enrollment for the subject in a non-placeholder course (endDate is null or in the future, and course metadata does not have placementPlaceholder set to true)
- Fetches the student’s highest grade mastered for the subject
- If the highest grade mastered is available, queries the assessment_results table for any existing fully-graded self-elected test-out at the next grade level (highestGradeMastered + 1)
- If the highest grade mastered is not available, falls back to the active course sequence to determine the lowest assessment grade for the subject and checks for a prior test-out at that grade
Returns eligible: true if no prior test-out exists at the target grade.
Returns eligible: false with a reason if the student has no qualifying active enrollment, or has already tested out.
Subject matching is case-insensitive. Supported subjects: Math, Reading, Language, Science, Writing, Vocabulary.
Documentation Index
Fetch the complete documentation index at: https://docs.timeback.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The OneRoster sourcedId of the student
The subject to check eligibility for