Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Get Assessment Results

get

Retrieve candidate attempts and scores for an assessment. Optionally filter results by candidate, activity, date range, or attempt status.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
workspace_idstringRequired

Workspace ID.

assessment_idstringRequired

Assessment ID.

Query parameters
speechace_user_idstringOptional

Optional Speechace user ID filter.

usernamestringOptional

Optional username filter.

emailstringOptional

Optional email filter.

date_fromstring · date-timeOptional

Optional ISO 8601 start timestamp, including timezone.

date_tostring · date-timeOptional

Optional ISO 8601 end timestamp, including timezone.

attemptsstringOptional

Optional attempt selection filter. The value all is accepted. Other accepted values depend on the API.

attempt_statestringOptional

Optional attempt-state filter. The value completed is accepted; all has also been tested with Assessment Results.

activity_idstringOptional

Optional activity ID filter.

Responses
200

Successful response containing assessment information, the result period, and candidate attempt records.

application/json
get/api/v1/workspaces/{workspace_id}/assessments/{assessment_id}/results
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