Assessment API

The Unified Assessment API enables assessment and background check providers to seamlessly integrate with Applicant Tracking Systems (ATS) platforms through a single, standardized interface. Recruiters can request assessments for candidates directly from within their ATS—Workable, Ashby, Greenhouse, and others—while assessment providers receive orders via webhooks and submit results back to the ATS, all with one API.

What is the Unified Assessment API?

ATS platforms like Workable, Ashby, and Greenhouse each have their own assessment APIs with different authentication methods, data models, and endpoints. The Unified Assessment API normalizes these differences, allowing assessment providers to build once and support multiple ATS platforms without maintaining separate integrations for each provider.

Unlike the Unified Verification API, where applications initiate requests to verification providers through Unified, the Assessment API connects directly into ATS “assessment APIs” and allows recruiters to request assessments without leaving their ATS. For assessment providers, this reduces friction for recruiters and keeps them in their familiar workflow.

Key Benefits for Developers

• Single Integration: Write code once to support Workable, Ashby, Greenhouse, and more—no need to learn multiple ATS assessment APIs
• Normalized Data Models: Work with consistent assessment package, order, and result structures across all supported ATS platforms
• Real-Time Webhooks: Receive assessment orders via webhooks as soon as recruiters request them, with no polling required
• Zero Maintenance: No need to track API version changes or deprecations across multiple ATS assessment integrations
• Faster Development: Ship ATS assessment integration features in days instead of months of integration work

Benefits for Product Managers

• Multi-Platform Support: Offer customers the ability to connect their preferred ATS platform without custom development
• Competitive Advantage: Launch with support for Workable, Ashby, Greenhouse, and more while competitors build integrations one at a time
• Customer Flexibility: Allow recruiters to request assessments from within their ATS without switching to a third-party interface
• Reduced Time-to-Market: Get assessment integration features to market quickly without waiting for engineering to build multiple integrations
• Scalable Product Strategy: Easily add new ATS platforms as they add assessment API support

Assessment Data Objects

The Assessment API provides access to the following standardized objects:

• Assessment Packages: Available assessment packages, pricing, and package configuration that ATS platforms display to recruiters
• Assessment Orders: Orders placed by recruiters when they request an assessment for a candidate, including candidate, job, and application details
• Order Results: Scores, status, completion timestamps, and custom attributes submitted back to the ATS when assessments are complete

Common Use Cases

Candidate Assessment Integration

Build assessment and testing tools that integrate with customers’ ATS platforms. Recruiters request assessments from within their ATS; your application receives orders via webhooks, sends assessments to candidates, and submits results back for recruiters to review.

Background Check Workflows

Connect background check services with ATS platforms that support assessment APIs. Recruiters initiate checks from within their ATS; your service processes the request, performs verification, and updates the order with results that appear directly in the ATS.

Skills and Aptitude Testing

Create skills assessment and aptitude testing products that work with Workable, Ashby, Greenhouse, and other supported ATS platforms. Recruiters order assessments for candidates; your platform delivers the test, scores it, and pushes results back to the ATS.

Interview Preparation Assessments

Build tools that deliver pre-interview assessments or preparation materials. Recruiters order assessments for candidates at specific pipeline stages; your application tracks completion and reports results back to the ATS.

Behavioral and Personality Assessments

Integrate behavioral or personality assessments into the hiring flow. Recruiters request assessments from within their ATS; your platform collects responses, computes scores, and submits structured results for recruiters to review alongside other candidate data.

Supported ATS Platforms

The Unified Assessment API supports integration with ATS platforms that offer assessment APIs, including Workable, Ashby, and Greenhouse. Each integration uses assessment-only connections that are separate from their standard ATS integrations.

Why Use a Unified Assessment API?

Traditional Approach:

• Build separate integrations for Workable, Ashby, Greenhouse, and each new ATS that adds assessment support
• Learn multiple authentication systems and API specifications
• Maintain code for different webhook formats, data models, and result submission endpoints
• Monitor and update integrations when any platform deprecates or changes their assessment API
• Handle platform-specific package structures, order payloads, and result formats

With Unified Assessment API:

• Integrate once with a single API that works across supported ATS platforms
• Use one authentication flow (Partner API Key) for all platforms
• Work with normalized assessment package and order objects
• Receive orders via standardized webhooks and submit results through a single update endpoint
• Built-in webhook support for assessment order creation and cancellation events

Integration Scenarios

For Assessment Software Providers

Add “Connect Your ATS” features that work with Workable, Ashby, Greenhouse, and other supported platforms. Configure assessment packages via the Unified API; receive orders via webhooks and submit results without building separate integrations for each ATS.

For Background Check Providers

Integrate background verification services with ATS platforms that support assessment APIs. Recruiters initiate checks from within their ATS; your service receives candidate details via webhooks, performs verification, and updates orders with results that appear in the ATS.

For Skills Testing Platforms

Connect skills and aptitude testing tools with customers’ ATS systems. Recruiters request assessments for candidates; your platform receives orders, delivers tests, scores responses, and pushes results back through the Unified Assessment API.

Real-Time, Live Data

The Unified Assessment API provides real-time access to assessment orders via webhooks. When a recruiter requests an assessment in their ATS, you receive a webhook immediately with the order details. Every result submission is written back to the source ATS in real time, ensuring recruiters see up-to-date assessment status and scores.

This real-time architecture is ideal for:

• Immediate notification when recruiters order assessments
• Live order status and result updates in the ATS
• Automated workflows that react to new orders and cancellations instantly

Privacy & Security

Unified.to never stores your customers’ assessment data. All requests are stateless and pass through to the ATS platforms directly. Traffic is regionalized (US/EU/AU) to comply with data residency requirements.