> For the complete documentation index, see [llms.txt](https://speaking-test-docs.speechace.com/speechace-speaking-test/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://speaking-test-docs.speechace.com/speechace-speaking-test/speaking-test-api/get-detailed-activity-result.md).

# Get Detailed Activity Result

Retrieve detailed assessment results for an individual Speaking, Writing, or Roleplay attempt.

The **Get Detailed Activity Result** endpoint uses a unique `result_id` to return candidate information, overall scores, and assessment-specific results.

Speaking and Writing responses include question-level answers and rubric scores. Roleplay responses include conversation transcripts, competency scores, and detailed performance feedback.

The block below provides a dropdown menu with sample JSON responses for three assessment types: Speaking Test (Books example), Writing Test (Technology example), and Roleplay (Sales Manager Interview example).

## Get Detailed Activity Result

> Retrieve detailed results for a Speaking, Writing, or Roleplay attempt using its unique result ID. The response includes rubric scores and either question-level responses or roleplay dialogue and feedback.

```json
{"openapi":"3.0.3","info":{"title":"Speechace Speaking Test API","version":"0.2.5-draft"},"tags":[{"name":"Get Detailed Activity Result"}],"servers":[{"url":"https://speak.speechace.co","description":"Speechace Speaking Test API"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"SpeakingDetailedActivityResult":{"type":"object","required":["version","title","name","email","shareable_link","default_rubric","attempt_state","date_of_attempt","duration","summary_of_scores","question_scores"],"properties":{"version":{"type":"string"},"title":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"shareable_link":{"type":"string","format":"uri","description":"Sensitive report URL; share only with authorized recipients."},"default_rubric":{"type":"string"},"attempt_state":{"type":"string"},"date_of_attempt":{"type":"string","format":"date-time"},"duration":{"type":"string","description":"Duration as reported by the API (H:MM:SS)."},"summary_of_scores":{"type":"array","description":"Scores use different scales; do not compare across rubrics.","items":{"type":"object","required":["rubric","score_details"],"properties":{"rubric":{"type":"string","enum":["TOEFL","IELTS","Speechace","PTE","TOEIC","CEFR"]},"score_details":{"type":"object","properties":{"fluency":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"vocab":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"grammar":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"pronunciation":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"task_achievement":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"overall":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"coherence":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]}}}}}},"question_scores":{"type":"array","minItems":1,"description":"Question-level transcripts/answers and rubric scores.","items":{"type":"object","required":["q_num","question_type","answer_transcript","question_scores"],"properties":{"q_num":{"type":"integer"},"question_type":{"type":"string","enum":["open-ended"]},"answer_transcript":{"type":"string","description":"Spoken transcription."},"question_scores":{"type":"array","items":{"type":"object","required":["rubric","score_details"],"properties":{"rubric":{"type":"string","enum":["TOEFL","IELTS","Speechace","PTE","TOEIC","CEFR"]},"score_details":{"type":"object","properties":{"fluency":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"vocab":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"grammar":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"pronunciation":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"task_achievement":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"overall":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"coherence":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]}}}}}}}}}}},"WritingDetailedActivityResult":{"type":"object","required":["version","title","name","email","shareable_link","default_rubric","attempt_state","date_of_attempt","duration","summary_of_scores","question_scores"],"properties":{"version":{"type":"string"},"title":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"shareable_link":{"type":"string","format":"uri","description":"Sensitive report URL; share only with authorized recipients."},"default_rubric":{"type":"string"},"attempt_state":{"type":"string"},"date_of_attempt":{"type":"string","format":"date-time"},"duration":{"type":"string","description":"Duration as reported by the API (H:MM:SS)."},"summary_of_scores":{"type":"array","description":"Scores use different scales; do not compare across rubrics.","items":{"type":"object","required":["rubric","score_details"],"properties":{"rubric":{"type":"string","enum":["TOEFL","IELTS","Speechace","PTE","TOEIC","CEFR"]},"score_details":{"type":"object","properties":{"fluency":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"vocab":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"grammar":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"pronunciation":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"task_achievement":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"overall":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"coherence":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]}}}}}},"question_scores":{"type":"array","minItems":1,"description":"Question-level transcripts/answers and rubric scores.","items":{"type":"object","required":["q_num","question_type","answer_transcript","question_scores"],"properties":{"q_num":{"type":"integer"},"question_type":{"type":"string","enum":["writing-describe-image","writing-essay"]},"answer_transcript":{"type":"string","description":"Original written answer (field name is preserved)."},"question_scores":{"type":"array","items":{"type":"object","required":["rubric","score_details"],"properties":{"rubric":{"type":"string","enum":["TOEFL","IELTS","Speechace","PTE","TOEIC","CEFR"]},"score_details":{"type":"object","properties":{"fluency":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"vocab":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"grammar":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"pronunciation":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"task_achievement":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"overall":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]},"coherence":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]}}}}}}}}}}},"RoleplayDetailedActivityResult":{"type":"object","required":["version","title","name","email","shareable_link","default_rubric","attempt_state","date_of_attempt","duration","summary_of_scores","question_scores","roleplay","roleplay_scoring"],"properties":{"version":{"type":"string"},"title":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"shareable_link":{"type":"string","format":"uri","description":"Sensitive report URL; share only with authorized recipients."},"default_rubric":{"type":"string"},"attempt_state":{"type":"string"},"date_of_attempt":{"type":"string","format":"date-time"},"duration":{"type":"string","description":"Duration as reported by the API (H:MM:SS)."},"summary_of_scores":{"type":"array","description":"Scores use different scales; do not compare across rubrics.","items":{"type":"object","required":["rubric","score_details"],"properties":{"rubric":{"type":"string","enum":["Numeric","Speechace","CEFR"]},"score_details":{"type":"object","description":"Competency keys are case-sensitive and may contain spaces.","additionalProperties":{"description":"Rubric-specific score; numeric, CEFR string, or null when unavailable.","anyOf":[{"type":"number","nullable":true},{"type":"string","nullable":true}]}}}}},"question_scores":{"type":"array","maxItems":0,"description":"Empty in the observed Roleplay response; use roleplay and roleplay_scoring.","items":{"type":"object"}},"roleplay":{"type":"array","minItems":1,"description":"Time-ordered AI and user dialogue turns.","items":{"type":"object","required":["role","text","timestamp","tone","proctoring"],"properties":{"role":{"type":"string","enum":["ai","user"]},"text":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"tone":{"type":"array","nullable":true,"items":{"type":"string"}},"proctoring":{"type":"object","nullable":true,"additionalProperties":true}}}},"roleplay_scoring":{"type":"object","description":"Competency names are dynamic keys, plus overall.","additionalProperties":{"type":"object","required":["score","band","description"],"properties":{"score":{"type":"number"},"band":{"type":"string","nullable":true},"description":{"type":"string"}}}}}},"APIError":{"type":"object","description":"Error details returned for an unsuccessful request.","required":["error"],"properties":{"error":{"type":"object","required":["message","request_id"],"properties":{"message":{"type":"string","description":"Human-readable error message."},"request_id":{"type":"string","description":"Request identifier used when contacting support."}}}}}},"responses":{"Unauthorized":{"description":"The request could not be authenticated because the API key is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}},"ResourceNotFound":{"description":"The requested resource could not be found or accessed. Check the resource identifiers and API key permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIError"}}}}}},"paths":{"/api/v1/activity-results/{result_id}":{"get":{"tags":["Get Detailed Activity Result"],"operationId":"getDetailedActivityResult","summary":"Get Detailed Activity Result","description":"Retrieve detailed results for a Speaking, Writing, or Roleplay attempt using its unique result ID. The response includes rubric scores and either question-level responses or roleplay dialogue and feedback.","parameters":[{"name":"result_id","required":true,"description":"Unique attempt result ID returned by Get Assessment Results or Get Activity Results.","schema":{"type":"string"},"in":"path"}],"responses":{"200":{"description":"Successful detailed Speaking, Writing, or Roleplay result. Select an example to inspect each response shape.","content":{"application/json":{"schema":{"description":"One of three observed detailed-result shapes. No top-level assessment-type field is returned.","oneOf":[{"$ref":"#/components/schemas/SpeakingDetailedActivityResult"},{"$ref":"#/components/schemas/WritingDetailedActivityResult"},{"$ref":"#/components/schemas/RoleplayDetailedActivityResult"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/ResourceNotFound"}}}}}}
```

For guidance on filtering assessment and activity results, interpreting empty responses, and troubleshooting API errors, see [**Filters, Errors and Examples**](https://speaking-test-docs.speechace.com/speechace-speaking-test/speaking-test-api/filters-errors-and-examples.md) .
