Order Checkr background checks and consume status webhooks

domain: checkr.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Authenticate by passing your Checkr API key as the Basic Auth username with an empty password on all requests to https://api.checkr.com/v1
  2. Create a candidate record by sending POST /v1/candidates with first_name, last_name, and email; store the returned id as the candidate_id for subsequent calls
  3. Order the background check by sending POST /v1/invitations with the candidate_id and the package slug (e.g., 'driver_pro', 'tasker_standard') to send the candidate a link to provide their information and consent
  4. Register a webhook endpoint in the Checkr Dashboard under Developer Settings; subscribe to events such as report.created, report.completed, and invitation.completed
  5. On each incoming webhook POST, verify authenticity by computing HMAC-SHA256 of the raw request body using your webhook secret key and comparing it to the X-Checkr-Signature header value
  6. When the report.completed event arrives, read the status (complete), result (clear or consider), and assessment fields from the payload; fetch the full report via GET /v1/reports/{reportId} if additional detail is needed

Known gotchas

Related routes

Handle Checkr webhook events for background check completion and adverse action
checkr.com · 5 steps · unrated
Order a Checkr background check on a candidate and receive results via webhook
docs.checkr.com · 5 steps · unrated
Handle Checkr background check webhook events and verify the X-Checkr-Signature header
checkr.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans