Get Assessment Results
Learn how to retrieve candidate attempts, assessment scores, and report information for a specific assessment.
The Get Assessment Results endpoint retrieves candidate attempts and results for a specific assessment, including candidate details, scores, completion status, and available report links.
This allows you to access assessment results programmatically for reporting or integration with your own applications.
The below block additionally displays the required path parameters, along with optional query parameters for filtering assessment results. You can explore code examples in different programming languages and review the possible API responses with sample JSON data.
Retrieve candidate attempts and scores for an assessment. Optionally filter results by candidate, activity, date range, or attempt status.
Workspace ID.
Assessment ID.
Optional Speechace user ID filter.
Optional username filter.
Optional email filter.
Optional ISO 8601 start timestamp, including timezone.
Optional ISO 8601 end timestamp, including timezone.
Optional attempt selection filter. The value all is accepted. Other accepted values depend on the API.
Optional attempt-state filter. The value completed is accepted; all has also been tested with Assessment Results.
Optional activity ID filter.
Successful response containing assessment information, the result period, and candidate attempt records.
The request could not be authenticated because the API key is missing or invalid.
The requested resource could not be found or accessed. Check the resource identifiers and API key permissions.
curl --request GET \
--url 'https://speak.speechace.co/api/v1/workspaces/{workspace_id}/assessments/{assessment_id}/results' \
--header 'Authorization: Bearer YOUR_RESULTS_API_KEY' \
--header 'Accept: application/json'{
"assessment": {
"id": "13971",
"title": "HR Interview",
"default_rubric": "Speechace"
},
"result_period": {
"date_from": "2026-07-01T00:00:00Z",
"date_to": "2026-10-20T15:19:21.551306Z"
},
"candidate_records": [
{
"result_id": "EXAMPLE_RESULT_ID",
"attempt_state": "completed",
"quiz_score": 0.5,
"quiz_cefr": "A0",
"pronunciation_score": null,
"fluency_score": null,
"vocab_score": null,
"grammar_score": null,
"task_achievement": null,
"coherence_score": null,
"accountability_score": null,
"adaptability_score": 0.5,
"collaboration_score": null,
"communication_score": 1,
"confidence_score": null,
"critical_thinking_score": null,
"domain_expertise_score": null,
"emotional_intelligence_score": null,
"empathy_score": 0.5,
"initiative_score": null,
"integrity_score": 1,
"leadership_score": null,
"learning_agility_score": null,
"motivation_score": null,
"problem_solving_score": 0.5,
"teamwork_score": null,
"time_management_score": null,
"report_url": "https://speak.speechace.co/placement/report/EXAMPLE_REPORT_ID",
"date_of_attempt": "2026-10-15T07:09:12.814187Z",
"tags": [],
"proctor": null,
"username": "example_candidate",
"full_name": "Example Candidate",
"email": "candidate@example.com",
"speechace_user_id": 1234567,
"invited_on": null,
"invited_by": null,
"activity_id": "20471",
"quiz_name": "HR Interview"
}
]
}Filtering assessment results
As indicated above , you can use optional query parameters to narrow assessment results by candidate, activity, date range, or attempt status.
You can filter by username, email, speechace_user_id, activity_id, date_from, date_to, attempts, and attempt_state.
For supported filter values, empty responses, and common API errors, see Filters, Errors and Examples.
The following section describes Get Activity Results and how to retrieve results for a specific activity within an assessment.
Last updated