Additional fields

Use the additional_fields query parameter on test_status to request detailed result data. Separate multiple field names with commas.

additional_fields=detailed_scores,strength_weaknesses,problem_statuses,problem_titles,proctoring_artifacts

The response places requested data inside the additional_fields object.

detailed_scores

An object with a CEFR-like score for each assessed category.

Property	Type
fluency	string
vocabulary	string
interaction	string
pronunciation	string
grammar	string

Each category may use one of these values:

A1, A1p, A2, A2p, B1, B1p, B2, B2p, C1, C1p, C2, C2p

strength_weaknesses

Contains text descriptions of the candidate's strengths and weaknesses.

{
  "strengths": ["strength1", "strength2"],
  "weaknesses": ["weakness1", "weakness2"]
}

problem_statuses

An array describing the candidate's response status for each test problem.

Value	Meaning
skipped	The candidate spoke 0 words.
warning	The candidate spoke more than 0 words, but not enough.
success	The candidate spoke enough words.
undefined	May appear in older assessments.

problem_titles

An array of titles for the problems completed during the test.

smalltalk_score

An integer from 0 to 100. The source response example includes this value inside additional_fields, though it is not listed as a requestable additional_fields option.

proctoring_artifacts

An array of objects with the proctoring mode and artifact URL.

[
  {
    "proctoring_mode": "IMAGE_ON_QUESTION",
    "url": "https://example.com/artifact"
  }
]

The URL above is illustrative; the source specification does not define the artifact URL format.