Skip to main content

Test Takers

List Test Takers

Make a GET request to /test-takers to retrieve a list of the most recent Test Takers created in your account.

note

Pagination and the ability to request the next set of items is coming soon. You can use the has_more property to determine if there are more for you to fetch. For now, only the most recent 30 items are returned.

GET /test-takers
{
"mode": "live",
"object": "list",
"total_count": 106,
"has_more": true,
"data": [
{
"object": "test_taker_list_item",
"id": 12345,
"first_name": "Linda",
"last_name": "Sample",
"email": "linda.sample@jofiscore.com",
"invitation_created_at": "2024-12-11T22:23:05.312696+00:00",
"invitation_id": 67890,
"custom_id": "example_Group4115",
"person_id": "example_nb5IHJjlHe5N7CNJ2afTC",
"career_navigation_profile_id": "CNP1234567890",
"assessment_url": "https://www.jofiscore.com/welcome/69608c33-1425-4123-9c49-22c5d9d7838c",
"career_navigation_url": "https://www.careernavigation.org?c=CNP1234567890",
"scorecard_url": "https://www.jofiscore.com/team/100/test-takers/12345/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CNP1234567890/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CNP1234567890/job-fit?r=cor&zones=1_5",
"team": {
"id": 100,
"display_name": "Recruiting"
},
"account": {
"id": 200,
"display_name": "Example Company Inc"
}
},
{
"object": "test_taker_list_item",
"id": 23456,
"first_name": "Oliver",
"last_name": "Sample",
"email": "oliver.sample@jofiscore.com",
"invitation_created_at": "2024-12-03T05:04:04.673371+00:00",
"invitation_id": 78901,
"custom_id": "example_Group4115",
"person_id": "example_18i7PCV_FlhJ_6NdzgwRo",
"career_navigation_profile_id": null,
"assessment_url": "https://www.jofiscore.com/welcome/1b9617a2-0297-47c7-930b-8fb8e8d4e4b7",
"career_navigation_url": null,
"scorecard_url": "https://www.jofiscore.com/team/100/test-takers/23456/scorecard",
"job_fit_summary_url": null,
"career_options_spotlight_url": null,
"team": {
"id": 100,
"display_name": "Recruiting"
},
"account": {
"id": 200,
"display_name": "Example Company Inc"
}
},
// truncated for brevity
{
"object": "test_taker_list_item",
"id": 34567,
"first_name": "Charlotte",
"last_name": "Sample",
"email": "charlotte.sample@jofiscore.com",
"invitation_created_at": "2023-08-04T19:06:53.921424+00:00",
"invitation_id": 89012,
"custom_id": "example_Group2281",
"person_id": "example_iRPHHcvLlmCHmFnrkCs_y",
"career_navigation_profile_id": "CNP2345678901",
"assessment_url": "https://www.jofiscore.com/welcome/f6b8646a-6f40-4df0-99a7-94aae3291d45",
"career_navigation_url": "https://www.careernavigation.org?c=CNP2345678901",
"scorecard_url": "https://www.jofiscore.com/team/100/test-takers/34567/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CNP2345678901/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CNP2345678901/job-fit?r=cor&zones=1_5",
"team": {
"id": 100,
"display_name": "Recruiting"
},
"account": {
"id": 200,
"display_name": "Example Company Inc"
}
},
{
"object": "test_taker_list_item",
"id": 45678,
"first_name": "Lorna",
"last_name": "Montey",
"email": "qa+testuser@jofiscore.com",
"invitation_created_at": "2023-07-21T02:22:35.502828+00:00",
"invitation_id": 90123,
"custom_id": "example_Group2281",
"person_id": "example_jPbNA6YSA-z-Q4uyvvFE_",
"career_navigation_profile_id": "CNP3456789012",
"assessment_url": "https://www.jofiscore.com/welcome/ce7e51b6-7370-41cf-93ef-8072628c2b6d",
"career_navigation_url": "https://www.careernavigation.org?c=CNP3456789012",
"scorecard_url": "https://www.jofiscore.com/team/100/test-takers/45678/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CNP3456789012/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CNP3456789012/job-fit?r=cor&zones=1_5",
"team": {
"id": 100,
"display_name": "Recruiting"
},
"account": {
"id": 200,
"display_name": "Example Company Inc"
}
}
]
}

Get Test Taker by ID

GET /test-takers/:testTakerId
{
"mode": "live",
"object": "test_taker",
"id": 12345,
"first_name": "Linda",
"last_name": "Sample",
"email": "linda.sample@jofiscore.com",
"invitation_created_at": "2024-12-11T22:23:05.312696+00:00",
"assigned_assessments": [
{
"id": 11111,
"created_at": "2024-12-11T22:23:28.311243+00:00",
"progress_saved_at": "2024-12-11T22:24:53.081+00:00",
"started_at": "2024-12-11T22:24:28.87+00:00",
"completed_at": "2024-12-11T22:24:53.996+00:00",
"is_used_for_scoring": true,
"assessment": {
"id": 8,
"display_name": "JOFI Career Interests",
"short_name": "Interests"
}
},
{
"id": 22222,
"created_at": "2024-12-11T22:23:28.311243+00:00",
"progress_saved_at": "2024-12-11T22:24:19.155+00:00",
"started_at": "2024-12-11T22:23:43.43+00:00",
"completed_at": "2024-12-11T22:24:20.518+00:00",
"is_used_for_scoring": true,
"assessment": {
"id": 6,
"display_name": "JOFI Personality Traits",
"short_name": "Personality"
}
}
],
"invited_by_user": {
"id": 33333,
"first_name": "Jane",
"last_name": "Recruiter",
"email": "jane.recruiter@jofiscore.com"
},
"team": {
"id": 100,
"display_name": "Recruiting"
},
"account": {
"id": 200,
"display_name": "Example Company Inc"
},
"assessment_url": "https://www.jofiscore.com/welcome/69608c33-1425-4123-9c49-22c5d9d7838c",
"career_navigation_url": "https://www.careernavigation.org?c=CNP1234567890",
"scorecard_url": "https://www.jofiscore.com/team/100/test-takers/12345/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CNP1234567890/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CNP1234567890/job-fit?r=cor&zones=1_5",
"invitation_id": 67890,
"custom_id": "example_Group4115",
"person_id": "example_nb5IHJjlHe5N7CNJ2afTC",
"career_navigation_profile_id": "CNP1234567890"
}