Recruitment Checks
Pre-hire credential screening sent to applicants (Recruit product).
List recruitment checks
Search recruitment checks. Filter by `status`, `applicantId`, `screeningPackageCode`, or free-text query across applicant name and email. Soft-deleted entries excluded by default.
Create recruitment check
Send a new credential check to an applicant. The applicant can be identified by synthetic id (`applicant.id = app_…`) or external id (`applicant.externalId` + optional `sourceSystem`). Requirements + per-credential guiding texts are snapshotted from the screening package referenced by `screeningPackageCode`. Returns 422 if the package is missing or inactive.
Re-send a recruitment check
Generates a fresh token, extends `tokenExpiresAt`, resets status to INITIATED so the mail action picks it up. Used when the original email bounced or was missed.
Send a reminder email
Increments `remindersSent` so the mail action sends a follow-up.
Cancel a recruitment check
Sets status to CANCELLED. The applicant's token link stops working.
Get recruitment check
Fetch a single check by id.
Soft delete a recruitment check
Soft delete a recruitment check
Partially update a recruitment check
Limited surface — only `message` and `expiryDays` are mutable. Status changes go through dedicated lifecycle endpoints; applicant + package are immutable.
List submitted credentials
Returns the credentials the applicant has uploaded against this check so far. Each entry surfaces the credential id + type + display name + status.