Get Screening for Job Submission
curl --request GET \
--url https://api.example.com/api/screening/submission/{jobSubmissionId}import requests
url = "https://api.example.com/api/screening/submission/{jobSubmissionId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/screening/submission/{jobSubmissionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/screening/submission/{jobSubmissionId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/screening/submission/{jobSubmissionId}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/screening/submission/{jobSubmissionId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/screening/submission/{jobSubmissionId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": 789,
"jobSubmissionId": 456,
"candidateId": 123,
"jobId": 789,
"currentScore": 66.67,
"potentialScore": 100,
"disqualify": false,
"submissionSummary": {
"screeningSummary": "The candidate meets most critical requirements including ICU experience and certifications...",
"followUpQuestions": [
"Are you willing and able to work night shifts?"
],
"missingInformation": [
"Night shift availability"
],
"strengths": [
"Current ACLS and BLS certifications"
],
"gaps": [
"Experience level slightly below requirement"
]
},
"applicationReadiness": {
"readinessScore": 75,
"status": "NeedsInformation",
"requiredDocuments": {
"missing": [
"PALS certification",
"Professional references"
],
"expiringSoon": [
"RN License (expires in 60 days)"
]
},
"qualificationGaps": {
"critical": [
"Night shift availability confirmation",
"PALS certification"
],
"recommended": [
"Additional year of ICU experience",
"Pediatric care experience"
]
},
"workHistoryGaps": {
"gaps": [
{
"startDate": "2022-06-01",
"endDate": "2022-08-15",
"duration": "2.5 months"
},
{
"startDate": "2023-01-01",
"endDate": "2023-03-01",
"duration": "2 months"
}
],
"totalGapDuration": "4.5 months"
},
"nextSteps": [
"Submit PALS certification",
"Provide professional references",
"Confirm night shift availability",
"Renew RN license"
]
},
"criteria": [
{
"id": 1,
"source": "job_criteria",
"question": "How many years of ICU nursing experience do you have?",
"criteria": "Minimum of 3 years ICU nursing experience required",
"type": "YearsOfExperience",
"status": "PartiallyMet",
"reasoning": "The candidate has 2 years of ICU experience...",
"textEvidence": "2 years of experience in Medical ICU"
}
],
"qualificationLevel": "Appropriate",
"isRelevant": true,
"candidate": {
"id": 123,
"name": "Jane Smith",
"location": "San Francisco, CA",
"yearsOfExperience": 2
},
"job": {
"id": 789,
"title": "ICU Nurse",
"location": "San Francisco, CA",
"department": "Nursing"
},
"createdAt": "2024-03-19T18:30:00Z"
}
Screening
Get Screening for Job Submission
Retrieve screening result for a specific job submission
GET
/
api
/
screening
/
submission
/
{jobSubmissionId}
Get Screening for Job Submission
curl --request GET \
--url https://api.example.com/api/screening/submission/{jobSubmissionId}import requests
url = "https://api.example.com/api/screening/submission/{jobSubmissionId}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/screening/submission/{jobSubmissionId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/screening/submission/{jobSubmissionId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/screening/submission/{jobSubmissionId}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/screening/submission/{jobSubmissionId}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/screening/submission/{jobSubmissionId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": 789,
"jobSubmissionId": 456,
"candidateId": 123,
"jobId": 789,
"currentScore": 66.67,
"potentialScore": 100,
"disqualify": false,
"submissionSummary": {
"screeningSummary": "The candidate meets most critical requirements including ICU experience and certifications...",
"followUpQuestions": [
"Are you willing and able to work night shifts?"
],
"missingInformation": [
"Night shift availability"
],
"strengths": [
"Current ACLS and BLS certifications"
],
"gaps": [
"Experience level slightly below requirement"
]
},
"applicationReadiness": {
"readinessScore": 75,
"status": "NeedsInformation",
"requiredDocuments": {
"missing": [
"PALS certification",
"Professional references"
],
"expiringSoon": [
"RN License (expires in 60 days)"
]
},
"qualificationGaps": {
"critical": [
"Night shift availability confirmation",
"PALS certification"
],
"recommended": [
"Additional year of ICU experience",
"Pediatric care experience"
]
},
"workHistoryGaps": {
"gaps": [
{
"startDate": "2022-06-01",
"endDate": "2022-08-15",
"duration": "2.5 months"
},
{
"startDate": "2023-01-01",
"endDate": "2023-03-01",
"duration": "2 months"
}
],
"totalGapDuration": "4.5 months"
},
"nextSteps": [
"Submit PALS certification",
"Provide professional references",
"Confirm night shift availability",
"Renew RN license"
]
},
"criteria": [
{
"id": 1,
"source": "job_criteria",
"question": "How many years of ICU nursing experience do you have?",
"criteria": "Minimum of 3 years ICU nursing experience required",
"type": "YearsOfExperience",
"status": "PartiallyMet",
"reasoning": "The candidate has 2 years of ICU experience...",
"textEvidence": "2 years of experience in Medical ICU"
}
],
"qualificationLevel": "Appropriate",
"isRelevant": true,
"candidate": {
"id": 123,
"name": "Jane Smith",
"location": "San Francisco, CA",
"yearsOfExperience": 2
},
"job": {
"id": 789,
"title": "ICU Nurse",
"location": "San Francisco, CA",
"department": "Nursing"
},
"createdAt": "2024-03-19T18:30:00Z"
}
Retrieve the screening result for a specific job submission. This endpoint returns a single screening result rather than a list.
Path Parameters
integer
required
ID of the job submission to get screening for
Response Fields
integer
Unique identifier for the screening
integer
ID of the job submission being screened
integer
ID of the candidate being screened
integer
ID of the job being screened against
number
Current match percentage based on verified criteria (0-100)
number
Maximum possible match percentage if all unverified criteria are met (0-100)
boolean
Whether the candidate should be disqualified from the job
object
Detailed screening analysis and recommendations
Show Summary fields
Show Summary fields
string
Overall assessment of the candidate’s fit for the position
array
Questions to ask the candidate about unverified or unclear criteria
array
List of criteria that couldn’t be verified from available information
array
List of criteria where the candidate shows strong matches
array
List of areas where the candidate doesn’t meet requirements
object
Analysis of application completeness and readiness to submit
Show Readiness fields
Show Readiness fields
number
Overall readiness score (0-100) based on completeness and qualification
string
Current status: “Ready”, “NeedsInformation”, “NeedsQualification”, “NotQualified”
object
object
object
array
Prioritized list of actions to improve application readiness
array
Detailed analysis of each criterion
Show Criterion fields
Show Criterion fields
integer
Unique identifier for the criterion
string
Origin of the criterion (e.g., “job_criteria”)
string
The criterion formatted as a question
string
Original criterion text
string
Type of criterion (e.g., “YearsOfExperience”, “Required”, “Preferred”)
string
Match status: “FullyMet”, “PartiallyMet”, or “NotMet”
string
Explanation of how the criterion was evaluated
string
Supporting text from resume/application, if found
string
Overall qualification assessment (e.g., “Appropriate”, “Overqualified”, “Underqualified”)
boolean
Indicates if the candidate’s background is relevant to the position
{
"id": 789,
"jobSubmissionId": 456,
"candidateId": 123,
"jobId": 789,
"currentScore": 66.67,
"potentialScore": 100,
"disqualify": false,
"submissionSummary": {
"screeningSummary": "The candidate meets most critical requirements including ICU experience and certifications...",
"followUpQuestions": [
"Are you willing and able to work night shifts?"
],
"missingInformation": [
"Night shift availability"
],
"strengths": [
"Current ACLS and BLS certifications"
],
"gaps": [
"Experience level slightly below requirement"
]
},
"applicationReadiness": {
"readinessScore": 75,
"status": "NeedsInformation",
"requiredDocuments": {
"missing": [
"PALS certification",
"Professional references"
],
"expiringSoon": [
"RN License (expires in 60 days)"
]
},
"qualificationGaps": {
"critical": [
"Night shift availability confirmation",
"PALS certification"
],
"recommended": [
"Additional year of ICU experience",
"Pediatric care experience"
]
},
"workHistoryGaps": {
"gaps": [
{
"startDate": "2022-06-01",
"endDate": "2022-08-15",
"duration": "2.5 months"
},
{
"startDate": "2023-01-01",
"endDate": "2023-03-01",
"duration": "2 months"
}
],
"totalGapDuration": "4.5 months"
},
"nextSteps": [
"Submit PALS certification",
"Provide professional references",
"Confirm night shift availability",
"Renew RN license"
]
},
"criteria": [
{
"id": 1,
"source": "job_criteria",
"question": "How many years of ICU nursing experience do you have?",
"criteria": "Minimum of 3 years ICU nursing experience required",
"type": "YearsOfExperience",
"status": "PartiallyMet",
"reasoning": "The candidate has 2 years of ICU experience...",
"textEvidence": "2 years of experience in Medical ICU"
}
],
"qualificationLevel": "Appropriate",
"isRelevant": true,
"candidate": {
"id": 123,
"name": "Jane Smith",
"location": "San Francisco, CA",
"yearsOfExperience": 2
},
"job": {
"id": 789,
"title": "ICU Nurse",
"location": "San Francisco, CA",
"department": "Nursing"
},
"createdAt": "2024-03-19T18:30:00Z"
}