Skip to main content
POST
/
storereviewerdetails
/
store
curl -X POST https://api.yourservice.com/api/v1/storereviewerdetails/store \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "recordVerificationId": "ver_live_abc123",
    "name": "Priya Sharma",
    "email": "priya.sharma@techcorp.com",
    "company": "TechCorp",
    "website": "https://techcorp.com"
  }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "name": "Priya Sharma",
    "email": "priya.sharma@techcorp.com",
    "company": "TechCorp",
    "website": "https://techcorp.com"
  },
  "message": "Reviewer details stored successfully"
}

​
Overview

Stores or updates the reviewer (endorser) for a given verification session. Checks for duplicate reviewer emails across the same skill and source before storing.
Applies to human endorsement verifications only.

​
Key Rule — Reviewer Email Uniqueness

For the same skill and source, each endorsement type must use a different reviewer email. If the same email is already associated with an endorsement for the same source under any other endorsement type, the request is rejected with DUPLICATE_REVIEWER_EMAIL.

​
Request Body

​
recordVerificationId
string
required
Verification session ID from POST /verify.
​
name
string
required
Full name of the reviewer.
​
email
string
required
Reviewer email address. Stored in lowercase. Must be a valid email format.
​
company
string
required
Company or organisation the reviewer belongs to.
​
website
string
Reviewer’s company website. Must be a valid URL if provided.

​
Error Codes

CodeHTTPDescription
MISSING_VERIFICATION_ID400recordVerificationId not provided
MISSING_NAME400name not provided
MISSING_EMAIL400email not provided
MISSING_COMPANY400company not provided
INVALID_EMAIL400Email format is invalid
INVALID_WEBSITE400Website is provided but not a valid URL
DUPLICATE_REVIEWER_EMAIL409Email already used as endorser for the same source
INTERNAL_ERROR500Unexpected server error
curl -X POST https://api.yourservice.com/api/v1/storereviewerdetails/store \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "recordVerificationId": "ver_live_abc123",
    "name": "Priya Sharma",
    "email": "priya.sharma@techcorp.com",
    "company": "TechCorp",
    "website": "https://techcorp.com"
  }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "name": "Priya Sharma",
    "email": "priya.sharma@techcorp.com",
    "company": "TechCorp",
    "website": "https://techcorp.com"
  },
  "message": "Reviewer details stored successfully"
}