GET test-result/…

Retrieves an individual test result for a specific test instance.

Test results can be stored at group level, or as individual results.

Resource URL

https://www.drillster.com/api/2/test-result/{test_id}

https://www.drillster.com/api/2/test-result/{test_id}/{user_id}

https://www.drillster.com/api/2/test-result/{test_id}/{ticket}

Parameters

Field	Type	Description
`test_id` required	String	The ID of the test definition. This defines the test itself, not the individual instances done by users. Example value: `7OuHq7RcQOCsnGWR58TnBw`
`user_id` optional	String	The user ID of the user to retrieve test details for. If omitted, the details for the own user account are returned. Example value: `j7Yvq-ynQeWNnHTNWRV9wA`
`ticket` optional	String	A ticket number issued by Drillster for use with anonymous tests. Example value: `jK8TJ11kcA7YvqUhd873kJ`

💡 Heads up

Either a user ID or a test ticket can be used, not both!

Response

A 2.0 TestResult object, with details about the test itself, the achieved score, and the individual given answers and corrections.

Example request

GET https://www.drillster.com/api/2/test-result/HmOZ3fMbRxulVH77XYR8nQ/GNiyJoCtRTyQmmy-P9xlfA

Response

{
  "completed": "2013-09-10T14:56:12Z",
  "correctlyAnswered": 0,
  "drills": [
    {
      "drill": {
        "id": "rCiRiK6gzUupEAmP2RAE1g",
        "name": "Hiragana",
        "subject": "Japanese",
        "type": "DRILL"
      },
      "score": 0
    }
  ],
  "includedColumnNames": [
    "Hiragana"
  ],
  "progress": 1.0,
  "questions": [
    {
      "answerColumn": "Rōmaji",
      "answered": true,
      "correct": false,
      "correctAnswer": "wo",
      "givenAnswer": "ya",
      "question": "ゃ",
      "questionColumn": "Hiragana"
    },
    {
      "answerColumn": "Rōmaji",
      "answered": true,
      "correct": false,
      "correctAnswer": "e",
      "givenAnswer": "ho",
      "question": "え",
      "questionColumn": "Hiragana"
    },
    {
      "answerColumn": "Hiragana",
      "answered": true,
      "correct": false,
      "correctAnswer": "そ",
      "givenAnswer": "ぜ",
      "question": "so",
      "questionColumn": "Rōmaji"
    },
    {
      "answerColumn": "Hiragana",
      "answered": true,
      "correct": false,
      "correctAnswer": "ぬ",
      "givenAnswer": "お",
      "question": "nu",
      "questionColumn": "Rōmaji"
    }
  ],
  "score": 0,
  "size": 4,
  "started": "2013-09-10T14:56:07Z",
  "style": "MULTIPLE_CHOICE",
  "subject": "Japanese"
}

Error responses

The following error situations are possible:

ID	Description
`missing_test_key`	No test key given.
`not_found`	The requested test result was not found.