reqCHECK

Installation

Quick start guide to get reqCHECK installed and working in minutes. For detailed configuration options, see the Widget Integration guide.

Prerequisites
What you need before getting started
  • ✓A reqCHECK account
  • ✓Access to your job application pages (HTML/JavaScript)
  • ✓Your Company ID from the dashboard settings

Note: API keys are only needed for backend verification lookup, not for the widget integration. The widget uses your Company ID.

Step 1: Get Your Company ID
Find your company ID in the dashboard

  1. Log in to your reqCHECK dashboard

  2. Navigate to Settings → Company

  3. Copy your Company ID

You'll need this Company ID for the widget script. API keys are only used for backend verification lookup, not in the widget.

Step 2: Load Widget Script
Add the widget script to your site

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

<!DOCTYPE html>
<html>
<head>
  <title>Job Application</title>
  <script src="https://cdn.reqcheck.io/widget.js" 
          data-reqcheck-company="your-company-id"></script>
</head>
<body>
  <!-- Your page content -->
</body>
</html>

The widget automatically scans for elements with data-reqcheck-mode and initializes them.

Step 3: Configure Widget Modes
Add mode attributes to your elements

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)
<!-- Example: protect mode for forms -->
<form data-reqcheck-mode="protect" data-reqcheck-job="job_123">
  <input type="email" name="email" required />
  <button type="submit">Submit</button>
</form>

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

Need more details? See the Widget Integration guide for detailed mode explanations, initialization options, and advanced configuration.

Step 4: Verify in Your Backend
Check verification status when processing applications

When a candidate passes verification, reqCHECK stores the result server-side with a 1-hour expiry. In your backend, call the Verification API to check if they passed before accepting the application.

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

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

API keys are generated from Settings → API & Webhooks in your dashboard and should only be used in your backend, never exposed in frontend code. Returns 404 if no valid verification found (within 1 hour).

Full API documentation: See the API Reference for complete endpoint documentation, response formats, and error handling.

Content Security Policy (CSP)
Required CSP directives for reqCHECK widget

If your site uses Content Security Policy headers, you'll need to allow reqCHECK domains. The required directives include:

  • script-src - Allow widget JavaScript
  • connect-src - Allow API calls
  • style-src - Allow widget styling

Need platform-specific examples? See the Widget Integration guide for complete CSP examples in Nginx, Apache, Next.js, and meta tags.

Browser Support
Supported browsers and feature detection

Supported Browsers

  • Chrome/Edge: Last 2 major versions
  • Firefox: Last 2 major versions
  • Safari: Last 2 major versions
  • Mobile: iOS Safari 14+, Chrome Android 90+

Not Supported

  • Internet Explorer (any version)
  • Opera Mini

The widget uses modern JavaScript (ES6+, Fetch API, Promises) and falls back gracefully in unsupported browsers with a message: "Please upgrade your browser to apply."

To manually test support: ReqCheck.isSupported()

Ready to integrate?

Continue to the widget integration guide for detailed configuration options.

Widget Integration