GuidesAPI ReferenceChangelog

Candidate Screening Order

A candidate is an individual who will go through the background check process as part of the recruitment, onboarding, or compliance related events. Paylocity will post the candidate information for screening using the webhook URL registered by the background check provider.

Paylocity is not responsible for candidate compliance nor PII. It is the sole responsibility of the background vendor to ensure that all compliance and PII steps are completed on their side. To ensure this, Paylocity recommends that the background check partners capture the candidate’s consent and the relevant PII data via their web/mobile experience. Paylocity will provide basic candidate information to the background check partner so that you can initiate the next steps in the journey by contacting the candidate via email or text messages.

Callback URL: The URL registered by your company to receive the candidate information for processing the screening request.

The table below explains the order and service statuses with the relevant definitions.

Order StatusDefinition
OrderedDefault status when the screening request is submitted. Screening partner doesn’t have to send this back to PCTY since it’s the default status.
WaitingOnCandidateWhen the screening partner has initiated the screening process by emailing the candidate.
InProgressWhen the candidate or employee has submitted the information required for screening. At this point the screen is in progress, and we are waiting for the background vendor to complete the orders.
HoldWhen more information is requested from the candidate or employee to run the screening.
CompleteWhen the screen is complete. At this point all the underlying service orders are completed (e.g., SSN trace, MVR, education verification, etc.) and a final report is available to the client.
PreAdverseActionSentWhen the pre-adverse action is initiated by the recruiter via the partner application.
AdverseActionCancelledWhen the adverse action is cancelled after the review.
DisputeWhen candidate disputes the adverse action.
AdverseActionSentWhen the adverse action is final, and the notice is sent.

The table below shows statuses of underlying services (e.g., SSN trace, MVR, education verification, etc.) of screening order.

Services StatusDefinition
PendingDefault status when the screening request is submitted. Screening partner doesn’t have to send this back to PCTY since it’s the default status.
InProgressWhen the candidate or employee has submitted the information required for screening. At this point the screen is in progress, and we are waiting for the background vendor to complete the orders.
CompletedWhen the screening for an underlying service is complete. Note: This does not mean that the order is complete. It only represents that the included screening within the package is complete.

Copyright © 2023 Paylocity. All Rights Reserved. Privacy Center | Terms and Conditions | Accessibility