Skip to main content
POST
/
humanverification
/
verify
curl -X POST "https://api.yourservice.com/api/v1/humanverification/verify?reviewerToken=uuid-reviewer-token" \
  -H "Content-Type: application/json" \
  -d '{ "skillIds": ["skill_001"] }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "skillsVerified": 1,
    "reviewerEmail": "priya.sharma@techcorp.com",
    "webhook": { "sent": true, "status": "sending" },
    "summary": {
      "totalSkillsVerified": 1,
      "totalProjects": 1,
      "totalExperience": 0,
      "totalCertificates": 0
    }
  },
  "message": "Skills verified successfully",
  "executionTime": "540ms"
}

​
Overview

Skills included in skillIds are marked verified. Skills currently pending but not included are marked rejected. After saving:
  • Fires a verification.completed webhook with full results.
  • Sends a confirmation email to the student.
  • Marks the reviewer session as completed (preventing re-submission).
  • Increments verifiedProfiles on the API key.
Uses the reviewerToken from the email link for authorisation — no session authentication required.

​
Query Parameters

​
reviewerToken
string
required
The reviewer token embedded in the email link.

​
Request Body

​
skillIds
string[]
required
IDs of the skills the reviewer is endorsing. Must not be empty.

​
Token Validation Rules

ConditionResult
Token not found401 INVALID_REVIEWER_TOKEN
Token found but expired410 REVIEWER_TOKEN_EXPIRED — session marked expired
Session already completed409 ALREADY_VERIFIED
Token valid and pendingProceeds normally

​
Error Codes

CodeHTTPDescription
MISSING_REVIEWER_TOKEN400reviewerToken query param not provided
MISSING_SKILL_IDS400skillIds is missing or empty
INVALID_REVIEWER_TOKEN401Token not found in live or test database
REVIEWER_TOKEN_EXPIRED410Review link has expired — student must resend
ALREADY_VERIFIED409This verification has already been completed
REVIEWER_NOT_FOUND404Reviewer details not found for this session
INTERNAL_ERROR500Unexpected server error
curl -X POST "https://api.yourservice.com/api/v1/humanverification/verify?reviewerToken=uuid-reviewer-token" \
  -H "Content-Type: application/json" \
  -d '{ "skillIds": ["skill_001"] }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "skillsVerified": 1,
    "reviewerEmail": "priya.sharma@techcorp.com",
    "webhook": { "sent": true, "status": "sending" },
    "summary": {
      "totalSkillsVerified": 1,
      "totalProjects": 1,
      "totalExperience": 0,
      "totalCertificates": 0
    }
  },
  "message": "Skills verified successfully",
  "executionTime": "540ms"
}