APIsResult Types

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.

NameAlgorithmResult Attr.Test Details
BasicbasicscoreGuide to analyzing results
Custom questionscustom_questionsscoreUsing custom questions
Personality

enneagram

disc

16_types

big_5

score_displayInterpreting personality tests
Culture addculture_fitscore_displayUsing 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:

  1. Extroversion
  2. Agreeableness
  3. Conscientiousness
  4. Emotional stability
  5. 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:

Big 5 personality test result

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:

disc
diissccd
idsicsdc

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:

ESTJENTJISTJINTJ
ESTPENTPISTPINTP
ESFJENFJISFJINFJ
ESFPENFPISFPINFP

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.