--- title: Checkr API Integration on Truto slug: checkr category: Background Verification canonical: "https://truto.one/integrations/detail/checkr/" --- # Checkr API Integration on Truto **Category:** Background Verification **Status:** Beta ## Unified APIs ### Unified User Directory API - **Me** — - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Checkr account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Checkr.** The Proxy API is a 1-to-1 mapping of the Checkr API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Trigger background checks directly from your hiring workflow** — ATS and HRIS platforms can let their customers initiate Checkr background checks when a candidate reaches a specific pipeline stage, eliminating manual data entry and context switching between systems. - **Automate continuous compliance for gig and marketplace platforms** — Workforce management and gig-economy SaaS companies can offer their customers automated recurring background checks and real-time monitoring, suspending workers when new flags appear without manual intervention. - **Embed tenant screening into property management software** — Property tech platforms can natively offer Checkr-powered background and eviction checks as part of their rental application flow, giving landlords a seamless approve/decline experience without leaving the app. - **Sync user directory data to streamline candidate creation** — SaaS platforms can pull user and role information from connected accounts via Truto's Unified User Directory API to pre-populate candidate records in Checkr, reducing friction and data entry errors for recruiters and ops teams. - **Offer a self-service Checkr account connection for your customers** — B2B SaaS companies can build a settings page where their end users connect their own Checkr accounts via OAuth, enabling multi-tenant background check workflows without sharing API keys. ## What you can build - **One-click Checkr account connection** — A settings page where your customers authorize their Checkr account via OAuth, with Truto handling token management and renewal. - **Background check package selector** — A native dropdown that fetches and displays the screening packages configured in your customer's Checkr account so they can select the right one without leaving your UI. - **Automated candidate invitation flow** — Push candidate PII from your platform to Checkr and generate a compliant hosted consent link, offloading SSN collection and FCRA compliance to Checkr. - **Real-time report status dashboard** — Listen to Checkr webhooks for report status changes and surface clear, consider, or pending badges inline within your product's candidate or worker profiles. - **User directory sync for candidate pre-population** — Use Truto's Unified User Directory API to pull users and roles from connected accounts, automatically mapping them to Checkr candidate records. - **Continuous monitoring alert engine** — Subscribe to Checkr's continuous check webhooks and automatically trigger account suspension or review workflows in your platform when a worker's background status changes. ## FAQs ### What authentication method does the Checkr integration use? Checkr supports OAuth 2.0 for partner integrations, allowing your end users to connect their own Checkr accounts. Truto manages the full OAuth flow, including token storage and refresh, so you don't have to. ### Are Checkr-specific tools available in Truto today? Checkr-specific tools (e.g., creating candidates, sending invitations, fetching reports) are built on request. Contact Truto to scope the exact endpoints and workflows you need, and they'll be added to your environment. ### What Unified APIs can I use with Checkr right now? Checkr is supported under Truto's Unified User Directory API, which covers Me, Roles, and Users resources. This lets you read user and role data from connected Checkr accounts in a standardized format. ### How does Truto handle Checkr's asynchronous background check lifecycle? Background checks are inherently async. Truto can relay Checkr webhooks (e.g., report.completed, report.engaged, continuous_check.status_changed) to your application so you can update your UI and trigger downstream workflows without polling. ### Does Truto handle pagination and rate limits for the Checkr API? Yes. Truto abstracts away pagination and respects Checkr's rate limits automatically, so your integration code doesn't need to manage cursor logic or retry backoff. ### Can my customers use their existing Checkr packages and adjudication rules? Yes. When your customer connects their Checkr account, you can query their configured packages and adjudication settings via the API. This means your product respects each customer's existing compliance configuration without any extra setup.