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": 1234512345,
"first_name": "Linda",
"last_name": "Sample",
"email": "linda.sample@jofiscore.com",
"invitation_created_at": "2024-12-11T22:23:05.312696+00:00",
"invitation_id": 1234612346,
"custom_id": "example_Group4115",
"person_id": "example_nb5IHJjlHe5N7CNJ2afTC",
"career_navigation_profile_id": "CP8ABC123HIJ",
"assessment_url": "https://www.jofiscore.com/welcome/69608c33-1425-4123-9c49-22c5d9d7838c",
"career_navigation_url": "https://www.careernavigation.org?c=CP8ABC123HIJ",
"scorecard_url": "https://www.jofiscore.com/team/328/test-takers/42558/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CP8ABC123HIJ/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CP8ABC123HIJ/job-fit?r=cor&zones=1_5",
"team": {
"id": 1234,
"display_name": "Recruiting"
},
"account": {
"id": 999,
"display_name": "CoffeeBean Inc"
}
},
{
"object": "test_taker_list_item",
"id": 2345623456,
"first_name": "Oliver",
"last_name": "Sample",
"email": "oliver.sample@jofiscore.com",
"invitation_created_at": "2024-12-03T05:04:04.673371+00:00",
"invitation_id": 2345723457,
"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/328/test-takers/42557/scorecard",
"job_fit_summary_url": null,
"career_options_spotlight_url": null,
"team": {
"id": 1234,
"display_name": "Recruiting"
},
"account": {
"id": 999,
"display_name": "CoffeeBean Inc"
}
},
// truncated for brevity
{
"object": "test_taker_list_item",
"id": 3456734567,
"first_name": "Charlotte",
"last_name": "Sample",
"email": "charlotte.sample@jofiscore.com",
"invitation_created_at": "2023-08-04T19:06:53.921424+00:00",
"invitation_id": 3456834568,
"custom_id": "example_Group2281",
"person_id": "example_iRPHHcvLlmCHmFnrkCs_y",
"career_navigation_profile_id": "CP1RTY789NOP",
"assessment_url": "https://www.jofiscore.com/welcome/f6b8646a-6f40-4df0-99a7-94aae3291d45",
"career_navigation_url": "https://www.careernavigation.org?c=CP1RTY789NOP",
"scorecard_url": "https://www.jofiscore.com/team/328/test-takers/42202/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CP1RTY789NOP/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CP1RTY789NOP/job-fit?r=cor&zones=1_5",
"team": {
"id": 1234,
"display_name": "Recruiting"
},
"account": {
"id": 999,
"display_name": "CoffeeBean Inc"
}
},
{
"object": "test_taker_list_item",
"id": 4567845678,
"first_name": "Lorna",
"last_name": "Montey",
"email": "qa+testuser@jofiscore.com",
"invitation_created_at": "2023-07-21T02:22:35.502828+00:00",
"invitation_id": 4567945679,
"custom_id": "example_Group2281",
"person_id": "example_jPbNA6YSA-z-Q4uyvvFE_",
"career_navigation_profile_id": "CP9DEF456KLM",
"assessment_url": "https://www.jofiscore.com/welcome/ce7e51b6-7370-41cf-93ef-8072628c2b6d",
"career_navigation_url": "https://www.careernavigation.org?c=CP9DEF456KLM",
"scorecard_url": "https://www.jofiscore.com/team/328/test-takers/41924/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CP9DEF456KLM/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CP9DEF456KLM/job-fit?r=cor&zones=1_5",
"team": {
"id": 1234,
"display_name": "Recruiting"
},
"account": {
"id": 999,
"display_name": "CoffeeBean Inc"
}
}
]
}

Get Test Taker by ID

GET /test-takers/:testTakerId
{
"mode": "live",
"object": "test_taker",
"id": 1234512345,
"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": 1234612346,
"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": 1234712347,
"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": 1234812348,
"first_name": "Jane",
"last_name": "Recruiter",
"email": "jane.recruiter@jofiscore.com"
},
"team": {
"id": 123123,
"display_name": "Recruiting"
},
"account": {
"id": 9999,
"display_name": "Example Account"
},
"assessment_url": "https://www.jofiscore.com/welcome/69608c33-1425-4123-9c49-22c5d9d7838c",
"career_navigation_url": "https://www.careernavigation.org?c=CP8ABC123HIJ",
"scorecard_url": "https://www.jofiscore.com/team/328/test-takers/42558/scorecard",
"job_fit_summary_url": "https://www.jofiscore.com/test-takers/CP8ABC123HIJ/job-fit?r=jfs&zones=1_5",
"career_options_spotlight_url": "https://www.jofiscore.com/test-takers/CP8ABC123HIJ/job-fit?r=cor&zones=1_5",
"invitation_id": 1234512345,
"custom_id": "example_Group4115",
"person_id": "example_nb5IHJjlHe5N7CNJ2afTC",
"career_navigation_profile_id": "CP8ABC123HIJ"
}