The Screening API allows JazzHR users to seamlessly integrate a Partners' screening services into their JazzHR recruiting workflow.
The workflow outlined below mimics the HR Open Standards for Submitting Screening Subject and Order at the same time.
When a JazzHR user decides to utilize a Screening Partner's integration, they must input a bearer token to verify the authentication credential. This bearer token uniquely identifies the user within the Screening Partner and is included in the header of all requests. See Authentication section below for more information.
JazzHR user selects a desired screening package from the Screening Partner catalog to incorporate in their recruiting workflow.
JazzHR user orders an assessment package for a particular candidate.
When creating the order, JazzHR will pass information about the person (subject) and package when creating the order.
The Screening Partner notifies JazzHR once the screening(s) are complete. JazzHR subsequently retrieves and stores the summary result.
[ "In Progress", "Completed", "Clear", "Needs Attention", "Cancelled", "Pending Recruiter Confirmation" ]
When the results are retrieved from the Screening Partner, the status value should be one of the following listed:
- In Progress: The screening is in progress.
- Completed: The screening was completed.
- Clear: The screening was completed and it is clear.
- Needs Attention: The screening was completed and/or it needs attention.
- Cancelled: The screening was cancelled.
- Pending Recruiter Confirmation: Additional confirmation is required in the partner system before initiating the screening.
Authorization: Bearer <token>
The bearer token associated with the verified JazzHR user will be included in the
Authorization header of all requests.
This bearer token should uniquely identify the user within the Screening Partner system.
To begin the integration process, please provide JazzHR with the following information:
- Test bearer token
JazzHR will provide the Screening Partner the following:
- A unique
- Sandbox access
- Screening Notification Url
More information concerning Screening API endpoints, requests, and responses can be found here.