Unified.to
All articles

ATS Assessment APIs in 2026: What Greenhouse, Workable, Ashby, Recruitee, TalentLyft and Cornerstone Require

·

Greenhouse, Workable, Ashby, Recruitee, TalentLyft and Cornerstone each publish a partner-only assessment API that lets your product appear inside the recruiter's hiring process; SmartRecruiters, Teamtailor, JobAdder and PageUp run assessment modules too. This guide compares the six, as of 20 October 2026. None of them are self-serve. Every one requires a partnership application, and most require you to host endpoints that the ATS calls rather than the other way round.

This guide covers what each one actually requires, where the differences bite, and what a unified assessment API changes. Every requirement below comes from the ATS's own developer, partner or help pages, read on 20 October 2026.

What is an ATS assessment API?

An ATS assessment API is a partner-only interface that lets an assessment or background-check company publish its catalogue into an applicant tracking system, receive orders when a recruiter requests a test, and return results to the candidate's record.

It is not the same as the general ATS API. On Greenhouse, Cornerstone and TalentLyft, the general API carries no assessment object at all. Assessments live on a separate surface with separate credentials and a separate approval process.

Three things distinguish it from an ordinary integration. The direction is usually inverted, meaning you host endpoints and the ATS calls them. Ordering is initiated by a recruiter inside the ATS rather than by your application. And results have a defined destination in the recruiter's interface, which is what makes the integration worth building.

How do the six compare?

DirectionEntry requirementOrderingScore in the recruiter's UI
GreenhouseYou host 4 endpoints1 mutual customer, signed agreementRecruiter clicks Send Test on an interview stageSortable and filterable, bulk actions
WorkableYou host 2 endpoints15 mutual customers for the native tierRecruiter action in the candidate timelineInjected into the candidate timeline
AshbyBoth sides hostIntro call, legal review, live demoRecruiter starts an assessmentStructured, on the candidate
RecruiteeBoth sides hostApplication, then Recruitee promotes youManual only, no stage triggeringReport entity on the candidate
TalentLyftYou host, they call backApplication, nothing else publishedRecruiter actionActivity feed and hover indicator
CornerstoneYou host, they configurePortal purchase or partnershipRecruiter action, or workflow itemSortable column, filtering not published

Greenhouse Assessment API

Greenhouse runs the most thoroughly documented of the six, and the most inverted. You host four HTTPS endpoints and Greenhouse calls all of them: list_tests returns your catalogue, send_test delivers an order, test_status returns the result, and an error endpoint (response_error in Greenhouse's endpoint list, request_errors in its example URL) is where Greenhouse reports its own failed calls back to you. One call runs the other way, a PATCH to a URL Greenhouse supplies with each order, which you use to signal completion.

Polling is deprecated. Greenhouse deprecated the polling model on 1 October 2019, and every implementation since must use that PATCH callback. Greenhouse still polls test_status hourly as a backstop, stopping when the candidate is hired, when it receives a complete status, or after eight weeks.

Getting in requires a mutual customer. At least one mutual customer must exist before Greenhouse will review your request. You also need an active website with a privacy policy, and you sign the Greenhouse Partnership Agreement once you qualify. Requests are reviewed on the first Monday of each month, and Greenhouse replies within seven business days of the review (Greenhouse partner page, as of 20 October 2026). Greenhouse's partner onboarding guide (dated March 2025) gives approved partners a six-month sandbox (as of 21 October 2026).

The result schema is thin. Greenhouse accepts partner_status, partner_profile_url, partner_score and a flat metadata object of JavaScript primitives. There is no maximum-score field, no sub-score structure and no file attachment. If your assessment produces sub-scores, metadata is the only place to put them.

Greenhouse documents the most for the recruiter of the six. Users can view the score, open your site for detail, filter candidates by score, and advance or reject in bulk. Greenhouse's help article for one live assessment integration says results may take up to an hour to appear in Greenhouse Recruiting.

No background-check partner specification. As of 20 October 2026, Greenhouse's partner documentation covers assessments only; background-check integrations exist only from the customer's side, through a section on the candidate's Application tab.

Workable Assessment API

Workable lists dedicated Assessment, Video Interview, Background Check and OAuth APIs, all "exclusively for partner use". They are documented apart from the general Workable ATS API.

You host two endpoints under a base URL you supply, one to list your available tests and one to create an assessment. Results go back to Workable.

Two tiers, and the threshold only applies to one. Native Integration Partners need a minimum of 15 mutual customers, get 50 requests per 10 seconds, an in-app listing, and first-line customer support from Workable. Third Party Integration Partners have no mutual-customer requirement, get 10 requests per 10 seconds, and own all support themselves. Workable names unified API providers explicitly as a valid route for that second tier (Workable partner page, as of 20 October 2026).

Applications are reviewed within a stated 15 days, and Workable expects the build itself to take under 90 days with sandbox access and QA support (Workable's partner application and partnership programme pages, as of 21 October 2026).

One thing Workable does not publish: whether the Assessment API specifically sits behind the 15-customer native threshold, or is reachable at the third-party tier. The partner page says the dedicated APIs are "exclusively for partner use" without saying which tier of partner. Worth clarifying before you plan around it.

Ashby Assessment API

Ashby's Assessments framework covers skills tests, reference checks and background checks through one surface rather than three.

It runs in both directions. You host assessment.start, assessment.list and assessment.cancel (and optionally customFields.fetch) at a base URL you give Ashby, and you call Ashby's assessment.update to report progress and assessment.addCompletedToCandidate to add a completed result. Ashby calls your API with Basic Auth, using a key the customer enters in Ashby's admin panel.

The process is a five-stage partnership with a demo at the end. An introduction call, then a legal review, then the build with technical support, then an end-to-end live demo of the integration to Ashby's team, then marketplace go-live and inclusion in their monthly customer newsletter.

No threshold and no stage durations are published. Ashby states no minimum customer count and no duration for any stage, beyond saying partners go to market in weeks rather than months; it wants a built solution before the introduction call. The sandbox it provides after legal review has no public documentation.

Recruitee Assessment API

Recruitee calls it the Partners API, and it runs on its own hostnames separate from the main ATS API. Assessment is a first-class type: partner.kind is an enum of assessment, background_check and reference_check, and the only difference between them is the label the recruiter sees, "Send test" against "Request background check".

Results are carried by a dedicated Report entity rather than being bolted onto candidate notes or attachments. You create a report, then patch it with status, score and URLs as the assessment progresses.

Ordering is manual only. Recruitee's own FAQ states that assessments can only be sent manually and that automated actions are on the roadmap with no date (as of 20 October 2026). If your product depends on triggering an assessment when a candidate reaches a stage, that does not exist on Recruitee. Recruitee also sends no email to the candidate, so candidate communication is entirely yours.

Recruitee controls when you go live. Development is confined by rule to their Release Candidate environment. Your partner record carries a promoted flag set to false, making you visible only to your own company, and Recruitee's team copies it to production and promotes it when they are satisfied. No review turnaround is published. The only timing figure Recruitee offers is an anecdote that some partners finished development in three days.

TalentLyft Assessment API

TalentLyft's Partner API has a documented assessments specification: you host a tests endpoint and an assessments endpoint, TalentLyft supplies a callback URL per order, and you send the result back to it (TalentLyft Partner API reference at developers.talentlyft.com, as of 21 October 2026).

The result schema is unusual. TalentLyft accepts Status, ResultsUrl, Score, Grade, Summary, Duration, Details and Attachments. Score is a string capped at 250 characters with a stated preference for a percentage, not a number with a scale, and there is no maximum-score field. Grade is a fixed enum of Poor, BelowAverage, Average and Superior. Details accepts JSON nested two levels deep, which is where sub-scores would have to go. Attachments accept PDF, DOC and DOCX up to 20MB. Your assessments endpoint should answer each order with a 201. If it responds with 300 or higher, TalentLyft resends the order after 10 minutes, up to five attempts in total, then discards it; no retry policy is published for your results callback.

The recruiter sees an activity feed, not a filterable field. Results appear on the candidate's activity feed with a downloadable report, plus a status indicator beside the candidate's name that a recruiter hovers over. TalentLyft does not publish whether the returned score or grade becomes a sortable or filterable candidate attribute, and their customer API exposes no assessment field on the candidate object.

Background checks are named but not specified. The Partner API reference lists Background checks as a category, but that page carries only conceptual prose. No endpoints, no fields, no payloads.

Nothing about the application is published either: no eligibility criteria, no review process, no timeline, and no visible form fields on the partner programme page.

Cornerstone Assessment API

Cornerstone's assessment surface is the Assessment Connector, part of its Edge connector family, and it is not part of the Recruiting REST API. There is a matching Background Check Connector.

One vendor per portal. This is the constraint that matters most and it has no equivalent among the other five. Cornerstone's developer guides for the Assessment Connector and the Background Check Connector each state that only one vendor can be integrated in a portal using the connector (csod.dev, as of 21 October 2026). Your customer cannot run you alongside a competitor. If they already have someone, replacing them is the only way in.

There are two mechanisms, and only one is documented. Alongside the connector, Cornerstone supports "External Assessment" as an application workflow item, keyed on a vendor-supplied solutionID. That path supports automatic disposition, where applicants scoring below a configurable threshold are moved to a Closed status with a Failed Pre-Screening disposition. The technical contract behind solutionID is not published.

Access runs through the customer or through partnership. Either your customer submits a purchase inquiry from the Edge Marketplace inside their portal, or you apply as a Technology Partner. No threshold, timeline or partner fee is published. Connectors are free to Cornerstone's clients, but the production API price is not published. Expect a separate commercial contract with the customer too: Cornerstone's page for DDI's integration says customers need a contract and purchased assessments from DDI (Cornerstone developer and help pages, as of 21 October 2026).

Auth is per tenant with no global partner credentials. Cornerstone calls your endpoints using HTTP Basic credentials that the customer types into their own portal.

The recruiter gets a sortable column. Cornerstone documents a per-assessment column on the Manage Applicants table carrying score and result, named after the assessment, permission-gated, and explicitly sortable. Whether it is filterable is not published.

What makes assessment integrations hard?

Four things, and none of them are the API call itself.

The direction is inverted. On five of the six, you host a web service the ATS calls on its own schedule. That is an availability commitment, not a client library. Your uptime becomes their integration's uptime.

Every result schema is different, and most are lossy. Greenhouse takes a number and a flat metadata object. TalentLyft takes a string and a four-value grade. Recruitee takes a Report entity. Cornerstone takes score plus result. If your assessment produces sub-scores, competency breakdowns or banded results, each ATS will flatten them differently, and on some of them the recruiter cannot sort on what you send.

Ordering models differ in kind, not just in detail. Greenhouse ties ordering to an interview stage. Recruitee supports manual sending only. Cornerstone has two separate mechanisms with different capabilities. A product built around stage-triggered assessments works on some of these and not others.

Partnership is the real gate. Greenhouse wants a mutual customer and a signed agreement before it reviews you. Workable's native tier wants fifteen. Ashby wants a live demo. Recruitee decides when you are promoted to production. Cornerstone lets your customer have exactly one of you. None of that is engineering, and none of it goes away because you chose a good API client.

What does a unified assessment API change?

A unified assessment API replaces the per-ATS endpoint stacks with one object model: you publish Package objects, receive each recruiter's Order by webhook, and write the result back on the same Order. On Unified.to, status, response_score and response_url are writable on every ATS assessment module, and all six ATSes above are covered (as of 19 October 2026). It doesn't remove the partnership: Greenhouse still wants its mutual customer and Ashby its demo. Setup steps are in How to Offer Assessment Packages and Receive Orders.

For the full comparison of unified assessment APIs, including Kombo, Knit and Merge, see How assessment and background check vendors integrate with ATS platforms.

→ Start your 30-day free trial

→ Book a demo

Frequently asked questions

Which ATS platforms have a dedicated assessment API? Six publish one with enough documentation to build against: Greenhouse, Workable, Ashby, Recruitee, TalentLyft and Cornerstone. Workable and Ashby also cover background checks through the same partner surface, Recruitee treats background checks and reference checks as sibling types of the same integration, and Cornerstone has a separate Background Check Connector. As of 20 October 2026, Greenhouse's partner documentation covers assessments only.

Can I trigger an assessment when a candidate reaches a pipeline stage? It depends on the ATS. Greenhouse ties the assessment to an interview stage, where the recruiter then clicks Send Test. Recruitee supports manual sending only and states that automated actions are on its roadmap with no date. Cornerstone's External Assessment path supports automatic disposition on score. If stage-triggered assessment is central to your product, verify it per ATS rather than assuming.

Do I have to host endpoints for an ATS assessment integration? On five of the six, yes. Greenhouse, Workable, TalentLyft and Cornerstone call endpoints you host. Ashby and Recruitee run in both directions, with a partner-hosted API alongside endpoints they publish for you to call. That makes your service's availability part of their integration, which is a different commitment from consuming an API.

How many mutual customers do I need before an ATS will work with me? Greenhouse requires at least one before it will review your request. Workable requires 15 for its native partner tier, though its third-party tier has no such requirement. Ashby, Recruitee, TalentLyft and Cornerstone publish no quantified threshold at all (as of 20 October 2026).

Can two assessment companies integrate with the same ATS customer? On Cornerstone, no. Its documentation states that only one assessment vendor can be integrated in a portal through the connector, and the same limit applies to background checks. The other five publish no such restriction.

Will the recruiter be able to sort candidates by my score? Greenhouse and Cornerstone both document a structured score the recruiter can act on, with Greenhouse also documenting filtering and bulk advance or reject. Cornerstone's column is sortable but filtering is not published. TalentLyft surfaces results on the activity feed with a hover status indicator and does not publish whether the score becomes a sortable attribute. Ask each ATS before you depend on ranking.


Written by Mallory Greene.

About the author: Mallory Greene is Head of Marketing at Unified.to_. She writes about integration infrastructure, unified APIs, and MCP for technical teams. Based in Toronto._

All articles