Send Reviewer Email

curl -X POST https://api.yourservice.com/api/v1/humanverification/send-email \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "reviewerEmail": "priya.sharma@techcorp.com",
    "reviewerName": "Priya Sharma",
    "skillCount": 2,
    "reviewLink": "https://review.yourservice.com?recordVerificationId=ver_live_abc123&reviewerToken=uuid-token",
    "expiresAt": "2025-05-09T10:00:00.000Z"
  },
  "message": "Reviewer email sent successfully",
  "executionTime": "320ms"
}

POST

humanverification

send-email

curl -X POST https://api.yourservice.com/api/v1/humanverification/send-email \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "reviewerEmail": "priya.sharma@techcorp.com",
    "reviewerName": "Priya Sharma",
    "skillCount": 2,
    "reviewLink": "https://review.yourservice.com?recordVerificationId=ver_live_abc123&reviewerToken=uuid-token",
    "expiresAt": "2025-05-09T10:00:00.000Z"
  },
  "message": "Reviewer email sent successfully",
  "executionTime": "320ms"
}

Overview

Generates a reviewer token (valid for 30 days), sends an email to the reviewer with a unique review link, fires a verification.initiated webhook, and increments your API key’s credit usage. Each call to this endpoint invalidates any previously issued token for the session and generates a fresh one.

Requires a valid session token via the x-api-key session middleware. All required data (reviewer, skills, session) is read from the session — no additional fields are needed in the request body.

Prerequisites

All of the following must be completed before calling this endpoint:

✅ Reviewer details stored via POST /storereviewerdetails/store
✅ Skills stored via POST /step1/storeskills/store
✅ Verification items stored via POST /step3/store-verification-items/store

Response

object

Show Response fields

string

The verification session ID.

string

Email address the link was sent to.

string

Name of the reviewer.

number

Number of skills included in this verification request.

string

The unique link sent to the reviewer. Contains the reviewerToken.

string

ISO 8601 timestamp when the reviewer token expires (30 days from send).

Error Codes

Code	HTTP	Description
`MISSING_VERIFICATION_ID`	400	No `recordVerificationId` found in session
`REVIEWER_NOT_FOUND`	404	No reviewer details stored for this session
`NO_SKILLS_FOUND`	404	No skills found for this session
`VERIFICATION_NOT_FOUND`	404	No aggregated verification data could be resolved
`EMAIL_SEND_FAILED`	500	Email constructed but failed to send via AWS SES
`INTERNAL_ERROR`	500	Unexpected server error

curl -X POST https://api.yourservice.com/api/v1/humanverification/send-email \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "reviewerEmail": "priya.sharma@techcorp.com",
    "reviewerName": "Priya Sharma",
    "skillCount": 2,
    "reviewLink": "https://review.yourservice.com?recordVerificationId=ver_live_abc123&reviewerToken=uuid-token",
    "expiresAt": "2025-05-09T10:00:00.000Z"
  },
  "message": "Reviewer email sent successfully",
  "executionTime": "320ms"
}

Overview

Skills

Selected Skills

Admin

Skill Verification

Step 1 — Skills

Step 2 — Verification Method

Step 3 — Source Items

Reviewer Details

Human Verification

Assessment Verification

Metadata

Overview

Prerequisites

Response

Error Codes

​Overview

​Prerequisites

​Response

​Error Codes

Overview

Prerequisites

Response

Error Codes