CoreVerify API

The CoreVerify API gives you programmatic access to background checks, candidates, packages, and adverse action workflows — the same features available in the dashboard.

Authentication

API keys, Bearer tokens, and security best practices

Candidates

Create and manage candidate profiles

Reports

Order background checks and retrieve results

Packages

Manage check packages and bundles

Adverse Actions

Initiate and track adverse action workflows

Webhooks

Receive real-time event notifications

Base URL

https://api.coreverify.com/v1

Quick Start

Create a candidate and order a background check in two API calls:

curl

# 1. Create a candidate
curl -X POST https://api.coreverify.com/v1/candidates \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+15551234567"
  }'

# 2. Order a background check
curl -X POST https://api.coreverify.com/v1/reports \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "candidateId": "cand_abc123",
    "packageId": "pkg_standard_criminal",
    "workState": "CA"
  }'

Response Format

All responses follow a consistent structure:

Success response

{
  "data": {
    "id": "ord_abc123",
    "status": "pending_candidate",
    ...
  }
}

Error response

{
  "error": {
    "code": "candidate_not_found",
    "message": "No candidate found with that ID",
    "status": 404
  }
}