APIsTest Results

Test Results

Retrieving assessment results

A detailed version of each candidate’s test results for a specific assessment can be pulled using the following API endpoint

Endpoint

GET https://app.testgorilla.com/api/assessments/results/?candidature__assessment=<ASSESSMENT_ID>&candidature__test_taker=<TESTTAKER_ID>


Query Parameters

ParametersDescription

candidature__assessment

<ASSESSMENT_ID>

This field is required.

candidature_test_taker

<TESTTAKER_ID>

This field is required.

Example Request

curl --location --request GET 'https://app.testgorilla.com/api/assessments/results/?candidature__assessment=<ASSESSMENT_ID>&candidature__test_taker=<TEST_TAKER_ID>' \
--header 'Authorization: Token <YOUR TOKEN GOES HERE>'

Example Response

{
 "count": n,
 "results": [
 {
 "id": 123456,
 "name": "Big 5 (OCEAN)",
 "score": null,
 "status": "published",
 "completed": true,
 "test_id": 494,
 "custom_questions": [],
 "algorithm": "big_5",
 "is_code_test": false,
 "score_display": "2-1-1-2-1_32.0-34.0-33.0-35.0-32.0",
 ...
 },
 {
 "id": 234567,
 "name": "Problem solving",
 "score": 85,
 "status": "filed",
 "completed": true,
 "test_id": 7244,
 "custom_questions": [],
 "algorithm": "basic",
 "is_code_test": false,
 "score_display": "",
 ...
 },
    {...}
  ]
}

Retrieving assessment results in PDF

Get the list of candidates for an assessment and use the response data and following mapping table to fill the data in Request below to get the results:

Endpoint

GET https://app.testgorilla.com/api/assessments/candidates/<TEST_TAKER_ID>/render_pdf/?candidature=<CANDIDATURE_ID>


Query Parameters

ParametersDescription

testtaker_id

<TESTTAKER_ID>

This field is required.

id

<CANDIDATURE_ID>

This field is required.

Example Request

curl --location --request GET 'https://app.testgorilla.com/api/assessments/candidates/<TEST_TAKER_ID>/render_pdf/?candidature=<CANDIDATURE_ID>' \
-H 'Authorization: Token <YOUR TOKEN GOES HERE>'