Result Types
Overview
Test result formats and representations are tied to the algorithm that is used to calculate it. The table below lists the algorithms, the attributes used, and how to analyze those results.
Name | Algorithm | Result Attr. | Test Details |
---|---|---|---|
Basic | basic | score | Guide to analyzing results |
Custom questions | custom_questions | score | Using custom questions |
Personality |
| score_display | Interpreting personality tests |
Culture add | culture_fit | score_display | Using the culture add test |
Basic Tests
Basic tests are those where the algorithm attribute equals basic. The score for these tests is returned in the score
attribute.
Custom Questions
Custom questions are represented by an extra test and the results are those where the algorithm attribute equals custom_questions
. The score
for these tests is returned in the score attribute.
Personality Tests
Big 5 (OCEAN)
The Big 5 personality test results are those where the algorithm attribute equals big_5
. For this test, the score_display
attribute provides two different representations of the test result, in an encoded string that contains two sections, separated by ”_”, with five values each:
-
Section 1: The calibrated score, from 1 (Very Low ) to 5 (Very High ) separated by “-“
-
Section 2: The original (unprocessed) score, in decimal values separated by “-“
Those five values correspond to the five factors in the following order:
- Extroversion
- Agreeableness
- Conscientiousness
- Emotional stability
- Openness to experience
You can pick the section you are interested in, splitting the string by ’_’ (underscore). You can then get each individual result by splitting the string again by ’-’ (dash).
Example: 2-1-1-2-1_30.0-29.0-33.0-26.0-31.0
- Section 1: 2-1-1-2-1
- Section 2: 30.0-29.0-33.0-26.0-31.0
Within TestGorilla, the result look like the image below:
Enneagram
The Enneagram personality test results are those where the algorithm attribute equals enneagram. For this test, the score_display
attribute has one of the following values:
- No results
- Improver
- Giver
- Go-getter
- Contemplator
- Pioneer
- The Devoted
- Cheerleader
- Master
- Agreeable
The only value that does not have a description is No results and will result in an HTTP 404 response if looked up using the description endpoint.
DISC
The DISC personality test results are those where the algorithm attribute equals disc. For this test, the score_display
attribute has one of the following values:
d | i | s | c |
di | is | sc | cd |
id | si | cs | dc |
16 types
The 16 types personality test results are those where the algorithm attribute equals 16_types
. For this test, the score_display
attribute represents the dominant letters across 4 scales: E-I, S-N, T-F, and J-P. As a result, the possible values are:
ESTJ | ENTJ | ISTJ | INTJ |
ESTP | ENTP | ISTP | INTP |
ESFJ | ENFJ | ISFJ | INFJ |
ESFP | ENFP | ISFP | INFP |
Personality Description
If you need a mechanism to dynamically pull a personality report, you can use the personality description endpoint, specifying the algorithm and the corresponding value to get detailed information about what each specific score means.
Endpoint
GET https://app.testgorilla.com/api/tests/personality/<ALGORITHM>/<SCORE>
Example Request
curl --location --request GET 'https://app.testgorilla.com/api/tests/personality/<ALGORITHM>/<SCORE>' \
--header 'Authorization: Token <YOUR TOKEN GOES HERE>'
Example Response
{
"personality":"..."
}
For example, if you want to get the details for INTJ - The Intellectual for 16 Types tests, you must send the algorithm 16_types
and the score value uses INTJ
in the URL.
curl --location --request GET 'https://app.testgorilla.com/api/tests/personality/16_types/INTJ' \
--header 'Authorization: Token <YOUR TOKEN GOES HERE>'
You will get a response like:
{
"personality":"<h2>INTJ - The Intellectual</h2>\n \n <h3>Description</h3>\n
<p>INTJs are systematic, analytical, and intuitive thinkers. This
is a rare combination, making it one of the least common personality
... "
}
Coding tests
Retrieving the time used on a coding test
Follow retrieving assessment detail to get the <TEST_RESULT_ID>
for the coding test to query:
Endpoint
GET 'https://app.testgorilla.com/api/assessments/results/<TEST_RESULT_ID>
Example Request
curl --location --request GET 'https://app.testgorilla.com/api/assessments/results/<TEST_RESULT_ID>/' \
--header 'Authorization: Token <YOUR TOKEN GOES HERE>'
Example Response
The response includes the total time allowed (duration) and the time used by the candidate (response_time), both in seconds.
{
"skill_areas_score":[],
"duration":1800.0,
"response_time":739
}
Retrieving the URL to a coding test report
Retrieve assessment detail to get the <TEST_RESULT_ID>
for the coding test to query:
Endpoint
GET 'https://app.testgorilla.com/api/assessments/code_questions/<TEST_RESULT_ID>/invitation_token
Example Request
curl --location --request GET 'https://app.testgorilla.com/api/assessments/code_questions/<TEST_RESULT_ID>/invitation_token/' \
--header 'Authorization: Token <YOUR TOKEN GOES HERE>'
Example Response
The response includes the code report UUID.
{"invitation_uuid":"<CODE_REPORT_UUID>"}
The report link is formatted as https://app.testgorilla.com/customer/candidates/code-report/<CODE_REPORT_UUID>
Note: With the above functionalities, you can manage your candidates inside your own system. To create assessments and write custom questions, you do need to access TestGorilla directly.