Test Takers and Scores
Get Test Taker by ID
Note that you will need a Test Taker ID to fetch the following data. You can get the Test Taker ID by calling Get Invitation by ID and looking at the test_taker_seats array in the response.
To fetch data for one Test Taker, make a GET request to the following endpoint:
/test-takers/:testTakerId
Example request
{base_url}/test-takers/45678?auth={auth_token}&sid={account_sid}
New Test Taker (no completed assessments)
The response below shows a brand new Test Taker. They have not yet started or completed any assessments (which you can see in the assigned_tests property, none of the assessments have a completed_at data).
{
"id": 45678,
"created_at": "2024-01-16T15:22:57.411622+00:00",
"invite_id": 112233,
"invited_by_user_id": null,
"invitation": {
"id": 112233,
"created_at": "2024-01-16T15:17:23.782834+00:00",
"accepted_at": "2024-01-16T15:22:57.289+00:00",
"first_name": "Gary",
"last_name": "DocsTest",
"sent_to_email": "gary.docstest@example-email.com",
"test_taker_magic_links": [
{
"id": "1764ba5d-ebdb-4593-a279-112233445566",
"created_at": "2024-01-16T15:17:23.896946+00:00",
"is_revoked": false,
"magic_link": "https://www.jofiscore.com/welcome/1764ba5d-ebdb-4593-a279-abcdef123456"
}
]
},
"team": {
"id": 4242,
"display_name": "Recruiting Team",
"account": {
"id": 8080,
"display_name": "Example Company, Inc."
}
},
"assigned_tests": [
{
"test": {
"id": 6,
"display_name": "JOFI Personality Traits"
},
"completed_at": null,
"created_at": "2024-01-16T15:22:57.479971+00:00",
"progress_saved_at": null,
"started_at": null
},
{
"test": {
"id": 8,
"display_name": "JOFI Career Interests"
},
"completed_at": null,
"created_at": "2024-01-16T15:22:57.479971+00:00",
"progress_saved_at": null,
"started_at": null
}
],
"test_taker_scores": [],
"top_occupations": [],
"riasec_letters": "",
"career_interests_profile": [],
"personality_traits": [],
"personality_traits_profile": []
}
Test Taker with Completed Assessments and Scores
After a Test Taker completes the assessments, they will have scores in the sections like test_taker_scores, career_interests_profile, etc. The examples that follow show the data you would receive for a Test Taker who has completed all of the assessments:
- JOFI Quick Prescreen
- JOFI Personality Traits
- JOFI Career Interests
- JOFI Thinking Skills.
The arrays shown as [...] below are expanded with sample data and descriptions in the following sections.
{
"id": 45678,
// ... excluding invitation and team info
// find descriptions of each property below
"assigned_tests": [...],
"test_taker_scores": [...],
"top_occupations": [...],
"riasec_letters": "RSC",
"career_interests_profile": [...],
"personality_traits": [...],
"personality_traits_profile": [...]
}
Assigned Tests (Assessments)
This section includes each of the JOFI assessments that were assigned for this Test Taker. Use the completed_at value to determine if the assessment is complete, and therefore should have scores.
"assigned_tests": [
{
"test": {
"id": 1,
"display_name": "JOFI Quick Prescreen"
},
"completed_at": "2024-01-16T22:57:17.961+00:00",
"created_at": "2024-01-16T22:56:36.012177+00:00",
"progress_saved_at": "2024-01-16T22:57:16.314+00:00",
"started_at": "2024-01-16T22:56:48.263+00:00"
},
{
"test": {
"id": 6,
"display_name": "JOFI Personality Traits"
},
"completed_at": "2024-01-16T22:58:49.76+00:00",
"created_at": "2024-01-16T22:56:36.012177+00:00",
"progress_saved_at": "2024-01-16T22:58:48+00:00",
"started_at": "2024-01-16T22:58:35.059+00:00"
},
{
"test": {
"id": 7,
"display_name": "JOFI Thinking Skills"
},
"completed_at": "2024-01-16T22:59:52.696+00:00",
"created_at": "2024-01-16T22:59:16.515344+00:00",
"progress_saved_at": "2024-01-16T22:59:51.869+00:00",
"started_at": "2024-01-16T22:59:30.37+00:00"
},
{
"test": {
"id": 8,
"display_name": "JOFI Career Interests"
},
"completed_at": "2024-01-16T23:00:48.285+00:00",
"created_at": "2024-01-16T22:59:16.515344+00:00",
"progress_saved_at": "2024-01-16T23:00:46.549+00:00",
"started_at": "2024-01-16T22:59:57.979+00:00"
}
],
Scores and the JOFI Scorecard
To save or display a Test Taker's scores similar to the JOFI Scorecard, use the test_taker_scores array. The score_component.display_name is the name of the row you would find on the JOFI Scorecard, and the score_value is a 1-9 value you would find shown in red, yellow, or green on the JOFI Scorecard.
"test_taker_scores": [
{
"score_value": 3,
"score_component": {
"id": 36,
"display_name": "Prescreen",
"short_name": "QPS-5"
}
},
{
"score_value": 4,
"score_component": {
"id": 10,
"display_name": "Ambitious",
"short_name": "con-amb"
}
},
{
"score_value": 7,
"score_component": {
"id": 24,
"display_name": "Analytical",
"short_name": "open-ana"
}
},
// additional scores removed for brevity
],
Here is a snippet of how the scorecard is displayed within JOFI:
Top Occupations
To save or display a Test Taker's top occupations, use the top_occupations array. The short_name (e.g. "JOFI-392-RS") corresponds to the JOFI Score Profile. The fullStarsCount is a 1-5 value used to represent the five-star score for the occupation, and the score value is the raw score which you can use to rank-order the occupations.
"top_occupations": [
{
"id": 238,
"score": 2,
"percentScore": 50,
"fullStarsCount": 3,
"short_name": "JOFI-392-RS",
"display_name": "Personal Care Services Zone 2"
},
{
"id": 699,
"score": 1.933,
"percentScore": 46.6,
"fullStarsCount": 3,
"short_name": "JOFI-392-CR",
"display_name": "Personal Care Services Zone 2"
},
{
"id": 687,
"score": 1.923,
"percentScore": 46.1,
"fullStarsCount": 3,
"short_name": "JOFI-332-RS",
"display_name": "Protective Services Zone 2"
},
// additional occupations removed for brevity
],
Here is a snippet of how the top occupations are displayed in the JOFI Job Fit Report:
Career Interests
The Test Taker's RIASEC letters are a string in the riasec_letters property. They correspond to top three interests out of the six RAISEC categories: Realistic, Investigative, Artistic, Social, Enterprising, and Conventional.
"riasec_letters": "RSC",
Here is a snippet of how the RIASEC profile is displayed in the JOFI Job Fit Report:
Find more detail about the sub-components within each RIASEC category in the career_interests_profile section, including the 1-9 score value for each sub-component.
"career_interests_profile": [
{
"groupId": 102,
"groupDisplayName": "Realistic",
"groupName": "ci-real",
"scoreComponents": [
{
"id": 113,
"displayName": "Construction",
"shortName": "ci-real-con",
"description": "High scoring individuals enjoy activities that involve constructing, renovating, or refinishing buildings and other infrastructure.",
"scoreValue": 6
},
{
"id": 114,
"displayName": "Production",
"shortName": "ci-real-pro",
"description": "High scoring individuals enjoy activities that involve extracting raw materials or transforming them into finished products using existing tools and machinery.",
"scoreValue": 8
},
{
"id": 115,
"displayName": "Engineering",
"shortName": "ci-real-eng",
"description": "High scoring individuals enjoy activities that involve designing, maintaining, and improving computers, equipment, structures, or processes.",
"scoreValue": 5
}
]
},
// additional career_interests_profile RIASEC items removed for brevity
],
Here is a snippet of how the career interests are displayed in the JOFI Job Fit Report:
Personality Traits
The Test Taker's top personality traits are found in the personality_traits section, including the name (e.g. "Analytical") and the score value.
"personality_traits": [
{
"scoreComponentId": 24,
"scoreComponentDisplayName": "Analytical",
"scoreComponentShortName": "open-ana",
"scoreValue": 7
},
{
"scoreComponentId": 12,
"scoreComponentDisplayName": "Principled",
"scoreComponentShortName": "con-prin",
"scoreValue": 6
},
{
"scoreComponentId": 21,
"scoreComponentDisplayName": "Balanced",
"scoreComponentShortName": "emot-bal",
"scoreValue": 5
},
{
"scoreComponentId": 6,
"scoreComponentDisplayName": "Compassionate",
"scoreComponentShortName": "agree-comp",
"scoreValue": 5
},
{
"scoreComponentId": 23,
"scoreComponentDisplayName": "Creative",
"scoreComponentShortName": "open-cre",
"scoreValue": 5
}
],
Here is a snippet of how the Personality Traits profile is displayed in the JOFI Job Fit Report:
Find more detail about the full Personality assessment scores in the personality_traits_profile section, including score values for each sub-component (e.g. the "Compassionate" sub-component within the "Agreeableness" personality trait).
"personality_traits_profile": [
{
"groupId": 5,
"groupDisplayName": "Agreeableness Overall",
"groupName": "agree",
"scoreComponents": [
{
"id": 6,
"displayName": "Compassionate",
"shortName": "agree-comp",
"description": "Indicates deep, emotional connections with others.",
"anchorLow": "Frank, focused, factual more than feelings; prefer working with data than people.",
"anchorHigh": "Affectionate, caring, sensitive; prefer close empathetic relationships.",
"scoreValue": 5
},
{
"id": 7,
"displayName": "Cooperative",
"shortName": "agree-coop",
"description": "Indicates an affinity for working with others.",
"anchorLow": "Cautious, competitive, skeptical; prefers working independently.",
"anchorHigh": "Pleasant, trusting, cordial, non-critical, easy to get along with.\n",
"scoreValue": 1
},
{
"id": 8,
"displayName": "Helpful",
"shortName": "agree-help",
"description": "Indicates an affinity for serving others.",
"anchorLow": "Independent, focused on own work; prefer individual contributor roles.",
"anchorHigh": "Generous with time and resources; prefer roles with opportunities to serve others.",
"scoreValue": 4
}
]
},
// additional personality_traits_profile items removed for brevity
]
Here is a snippet of what the personality traits are displayed in the JOFI Job Fit Report:
That's all you need to know to use the JOFI API! Please don't hesitate to reach out to the JOFI team with questions or suggestions.