reqCHECK

Getting Started

Welcome to reqCHECK! This guide will help you get up and running in minutes.

What is reqCHECK?
Understanding the core concept

reqCHECK is a gate-first skill verification platform that overlays your existing job application forms. Instead of allowing anyone to submit an application, candidates must first pass a short skill verification challenge.

Think of it like reCAPTCHA for job applications—but instead of proving you're human, candidates prove they understand the job's core skills.

Key Benefits:

  • Reduce unqualified applicants
  • Save 5-10 hours per role on manual screening
  • Improve candidate experience with instant feedback
  • Keep your ATS clean and spam-free
Quick Start
Connect reqCHECK to your existing application form in three simple steps

1. Load the widget script

Add the widget script to your <head> section with your company ID. The script loads once and works across all pages.

2. Choose a widget mode

Add data-reqcheck-mode and data-reqcheck-job to your elements. Three modes available:

  • protect - Form overlay mode (traditional application forms)
  • gate - Redirect protection mode (external ATS links, buttons)
  • inline - Custom placement mode (widget renders in specific location)

3. Auto-initialization

The widget automatically scans for elements with data-reqcheck-mode and initializes them. No additional code needed! You can disable auto-init and control timing manually if needed 

<!-- In <head> - set once -->
<script src="https://cdn.reqcheck.io/widget.js" 
        data-reqcheck-company="your-company-id"></script>

<!-- On any page, any element -->
<form data-reqcheck-mode="protect" data-reqcheck-job="job_123">
  <!-- your existing application fields -->
</form>

<!-- Or for external links -->
<a href="https://jobs.greenhouse.io/apply/123" 
   data-reqcheck-mode="gate" 
   data-reqcheck-job="job_456">
  Apply Now
</a>

Optional: manual initialization

If you need to wait for consent banners, dynamic routing, or other app state, leave off data-reqcheck-company and call ReqCheck.init yourself once you're ready:

<!-- Optional: disable auto-init -->
<script src="https://cdn.reqcheck.io/widget.js" 
        data-reqcheck-company="your-company-id"
        data-reqcheck-auto-init="false"></script>

<script>
  // Manual control
  ReqCheck.init({
    companyId: "your-company-id",
    mode: "gate",
    jobId: "job_123",
    selector: "#custom-apply-btn"
  });
</script>
Backend Verification
Checking verification status in your backend

When a candidate passes verification, reqCHECK stores the result server-side with a 1-hour expiry. When the candidate submits their application form, your backend should call the Verification API to check if they passed before accepting the application. Remember to include the x-api-key header with an API key generated from the dashboard.

POST /api/v1/verify
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "externalJobId": "job_123",
  "email": "candidate@example.com"
}

The API returns verification status including whether they passed, their score, and when they completed the quiz. Returns 404 if no valid verification found (within 1 hour).

Security: API keys are only used in your backend for verification lookup. Never expose them in frontend code or include them in the widget script. Verifications are stored server-side - no tokens are injected into forms.

How It Works
The verification flow
1

Candidate Clicks Apply

A candidate visits your job application page and clicks the "Apply" button.

2

Widget Overlay Appears

The reqCHECK widget overlays the form, asking the candidate to verify their skills before proceeding.

3

Email Capture

The candidate enters their email address. This enables rate limiting and prevents spam.

4

Skill Challenge

The candidate answers up to 5 questions tailored to the job's detected skills. Questions are automatically generated based on the job description.

5

Pass or Fail

If they pass (≥60% by default, configured in dashboard), the verification is stored server-side with a 1-hour expiry. The widget performs mode-specific action (unlock form, redirect, or enable elements). If they fail, they see a message with retry information.

6

Backend Verification

When the candidate submits their application, your backend calls the Verification API with their email and job ID to check if they passed before accepting the application.

Next Steps
Continue your journey

Installation Guide

Learn how to install and configure reqCHECK

Read Guide

Widget Integration

Step-by-step widget integration instructions

Read Guide