Assessment score

Request body parameters

command

string required

Set to "score_calc_get".

partner_api

boolean required

Set to true.

application_id

integer int64 or string required

ID of assessment

language_id

string

Any supported 3-letter language code. Consult SMG for which languages are available for each assessment type. If omitted, language originally supplied in Application create command will be used.

show_traits

boolean

Include trait scores in response

show_super_traits

boolean

Include super trait scores in response

show_reducers

boolean

Include reducer information in response

show_answers

boolean

Include questionnaire answers in response

Response body JSON

error_code

integer int64

Error code

error_text

string

Error text

command_from

string

The command used to generate this response ("score_calc_set")

language_id

string

3-letter language code of language assigned to assessment

main_score_found

boolean

Whether assessment provides a main score

score

number

Main score; only present if main_score_found: true in request

score_final

number

Reducer main score; normally a number from 1 to 3 representing recommended decision for candidate (1: redirect, 2: proceed with caution, 3 or more: proceed); only present if main_score_found: true in request

score_text

string

Textual interpretation of main score; only present if main_score_found: true in request

avalue

number

Same as score_final

caption_tr_score

string

Same as score_text

traits

Array of object

Array of trait scores; only present if show_traits: true in request

_{Child attributes}

trait_name

string Name of trait

caption_tr

string Trait name translated into requested language

score

number Trait score

super_traits

Array of object

Array of super trait scores; only present if show_super_traits: true in request

_{Child attributes}

trait_name

string Name of super trait

caption_tr

string Super trait name translated into requested language

score

number Super trait score

answers

Array of object

Array of questionnaire answers; only present if show_answers: true in request

_{Child attributes}

q

string Question ID

c

string Question name

t

string Question text

a

integer int64 or string Candidate's answer; for multiple-choice questions, the choice number as an integer; for text questions, the candidate's answer as a string

v

string For multiple-choice questions only, the text of the candidate's choice

position_reducers

Array of object

Array of reducers; only present if show_reducers: true in request

_{Child attributes}

aname

string Name of the reducer

caption_tr_rdc

string Title of the reducer, translated into the requested language

score

number Reducer score

score_final

number Reducer final score

score_text

string Reducer descriptive text, translated into the requested language

trait_name

string Name of primary trait used to calculate reducer score

Error codes