A unified Screening API overcomes typical integration challenges by standardizing inconsistent data models, normalizing varied terminology, and creating a consistent entity structure where candidate screening data, background checks, assessments, and results exist predictably regardless of which screening provider your customer uses.

Benefits of StackOne Screening API

Here are some benefits of using our Screening API that simplifies and enhances candidate screening processes:

Key Features

The table below shows key features of the Screening API that make candidate screening easier, from background checks to skills assessments:

FeatureDescription
Background Check ManagementEasily initiate, track, and retrieve results for various types of background checks.
Assessment IntegrationManage candidate assessments, from technical skills tests to personality evaluations.
Real-Time WebhooksReceive instant notifications for screening status updates and completed results.

Entity Model and Relationships

The following diagram illustrates the key entities within the Screening API:

The following table outlines key entities within the Screening system and provides a brief description of each.

EntityDescription
CandidateContains essential candidate information required for screening, including first name, last name, and email.
ScreeningOrderRepresents a screening request for a candidate using a specific package, including any custom fields or provider-specific data.
ScreeningPackageDefines available screening services, including name, description, and provider-specific configuration.
ScreeningResultContains the outcome of a screening order, including status, summary, scoring, and access to detailed results.
ResultScoreRepresents the scoring details of a screening result, with label, value, and score range.
ProviderRepresents the screening service providers integrated with the system.
WebhookEventDefines the structure of webhook notifications for screening status updates and results.

The API supports the following screening result statuses:

  • pending: Initial state when the screening is requested

  • in_progress: Screening is currently being processed

  • completed: Screening has been successfully completed

  • failed: Screening process encountered an error

  • cancelled: Screening was cancelled before completion

Webhook events are triggered for the following scenarios:

  • screening.result.created: New screening result created

  • screening.result.updated: Existing result updated

  • screening.result.completed: Screening process completed

  • screening.result.failed: Screening process failed

  • screening.result.cancelled: Screening was cancelled

Use cases

Automated Background Checks

Streamline your hiring process by automatically initiating background checks when candidates reach specific stages.

Assessment Integration

Seamlessly incorporate skills assessments and personality tests into your hiring workflow.