API & Integrations

ReferenceExpert fits inside the tools you already use.

Our REST API lets you request references automatically, follow their progress and pull completed reports into your applicant tracking system, HR system or dashboard, without anyone logging into a separate platform.

Capabilities

What the API lets you do

Four core operations cover most integration needs out of the box.

Request references

Start a reference request from your own system. Pass the candidate, the reference type and who to ask. No manual steps required.

Track progress

Check where every request stands, from sent to completed, and show that status inside the tools your team already uses.

Receive webhooks

Get notified when a referee completes a reference, so your systems update without polling.

Pull reports

Retrieve completed reports and their answers, ready to file against the candidate or employee record.

Where it connects

The systems teams connect most often

Your system asks. ReferenceExpert collects. The answers come back to where your team already works.

Applicant tracking systems

Request references automatically when a candidate reaches the right stage. Status and completed reports write back into the candidate record, so there is no copying, pasting or switching tabs.

Request at offer stageStatus syncReport write-back

HR systems

Completed references sit alongside the employee record, ready for onboarding checks and audit, instead of in an inbox or a shared drive.

Employee recordOnboarding checksAudit trail

Dashboards and BI tools

Pull reference data into your reporting. Follow completion and turnaround by role, site or hiring manager over time.

Power BITableauLookerYour own dashboard

Custom builds

Running an internal talent platform or recruitment portal? The API gives you full programmatic control, with a sandbox and documentation to speed up your build.

SandboxDocumentationWebhooks
Getting connected

Up and running in three steps

We set you up, your developers build, and we review the connection with you before it goes live.

Talk to us about integrating
  1. 1

    We issue your API credentials

    Once API access is agreed, we issue OAuth 2.0 credentials scoped to your account, and set up a sandbox so your developers can test against real data structures without touching live candidates.

  2. 2

    Your team builds the connection

    Using the REST API documentation, your developers connect the endpoints you need. We are available throughout for technical questions, and to review your integration before it goes live.

  3. References flow automatically

    Once live, requests go out, referees reply and webhooks tell your systems, without anyone opening ReferenceExpert directly. Your team works inside the tools they already use.

Technical spec

Built on straightforward, modern standards

No proprietary protocols and no unusual dependencies. A clean REST API your developers will recognise straight away.

ProtocolREST / JSON

HTTPS only. JSON request and response bodies. Standard HTTP status codes throughout.

AuthenticationOAuth 2.0

Client credentials flow. Short-lived access tokens with a scope set for each integration.

EventsWebhooks

Signed payloads sent to your endpoint when a reference is completed, a reminder goes out or a status changes.

TestingSandbox

A full sandbox with simulated candidates and referees. Build and test without touching live data.

API access is available as an add-on

ReferenceExpert is priced per reference, with a one-off set-up fee. API access, which connects the platform to your own systems, is priced separately based on the scope of your integration.

Pricing depends on the type of connection and how many systems you are connecting. Contact us to talk through your setup and get a quote.

Ready to connect ReferenceExpert to your systems?

Talk to us about your integration. We will tell you whether it is straightforward or needs scoping, and give you a realistic quote and timeline.