GET tests

Retrieves tests of the requesting user. If a test has been completed, the results are included, too.

Resource URL

https://www.drillster.com/api/2.1.1/tests

Parameters

Field	Type	Description
`filter` optional	String	The filter to apply to the tests: `COMPLETED` to show only completed tests. `OPEN` to show only open tests. Open tests are tests that have not yet been completed, or completed tests that are being re-taken.

Response

A 2.1.1 Tests object containing the number of tests, plus a list of 2.1.1 Test objects, with details about the test itself, the achieved score, progress, start and end date. Test results are included as 2.1.1 TestResult objects.

Example request

GET https://www.drillster.com/api/2.1.1/tests

Response

{
  "total" : 3,
  "open" : 2,
  "completed" : 1,
  "tests" : [ {
    "id": "bll4SqojZ2zvdMxYnFT6FA",
    "title": "Famous actors",
    "drills" : [ "vEnKzwihv2NPSArwvdteww.Wy75", "Ij9-TPxnbLc_7VS-hIuUbg.Qc2G" ],
    "direction": "BIDIRECTIONAL",
    "style": "MULTIPLE_CHOICE",
    "group": "ubbI_HxUr2-UhMEkz0gqqKB-0wzeHAJzM6vlL1te6wI",
    "testType": "GROUP",
    "disclosure" : [ "OVERALL_SCORE", "CORRECTIONS", "COMPONENT_SCORES", "METADATA" ],
    "columns" : [ "Period", "Actor / Actress" ],
    "questions" : [ 23 ],
    "created": "2014-07-16T09:18:09Z",
    "testResults" : [ {
      "score" : {
        "percentage" : 78
      },
      "started": "2014-07-16T09:19:56Z",
      "completed": "2014-07-16T09:20:21Z",
      "progress" : 1.0,
    } ],
    "icon" : {
      "type": "image/jpeg",
      "url": "https://www.drillster.com/bin/feature/b68b28a4da2287c5c9b5861543b8144bc1720fed"
    }
  }, {
    "id": "juo41SxWoJYBY_XhzZ3jPg",
    "title": "French vocabulary",
    "drills" : [ "VPZVb_UPStSLmVWdGgG8WA.4o9V" ],
    "direction": "RECEPTIVE",
    "style": "MULTIPLE_CHOICE",
    "group": "ubbI_HxUez-UhMfkz0gqMKB-0wzeHAJzM6vlL1te6wI",
    "testType": "GROUP",
    "disclosure" : [ ],
    "columns" : [ "French" ],
    "questions" : [ 25 ],
    "created": "2014-09-05T12:45:46Z",
    "icon" : {
      "type": "image/jpeg",
      "url": "https://www.drillster.com/bin/feature/b68b28a4123287c5c9b586f9cb48144bc1720fed"
    }
  } ]
}

Last updated on 2025-04-18