The Revelian Assessment API brings the power of Revelian assessments to your recruitment process. It allows you to select the assessments you’d like to use for a particular recruitment exercise, invite candidates to complete them, and then receive their results within your own ATS or HR system. All of this gives you more objective and scientifically validated information to help inform your selection decisions.

To access the Revelian Assessment API, you’ll firstly need to obtain a Client Identifier and API key. Contact Revelian for more information about getting started.

The Revelian API follows a RESTful convention. It uses HTTP methods/verbs, HTTP response codes, and resource-oriented URLs.

All requests and responses (including errors) are in JSON.

Base URL

All URLs referenced in the documentation have the following base:


To ensure data privacy all requests are over HTTPS. HTTP is not supported.