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"
}
{
"success": false,
"error": {
"code": "DUPLICATE_REVIEWER_EMAIL",
"message": "This email is already used as an endorser for the same source."
}
}
Reviewer Details
Store Reviewer Details
Store the endorser details for a human verification session.
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"
}
{
"success": false,
"error": {
"code": "DUPLICATE_REVIEWER_EMAIL",
"message": "This email is already used as an endorser for the same source."
}
}
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 withDUPLICATE_REVIEWER_EMAIL.
Request Body
string
required
Verification session ID from
POST /verify.string
required
Full name of the reviewer.
string
required
Reviewer email address. Stored in lowercase. Must be a valid email format.
string
required
Company or organisation the reviewer belongs to.
string
Reviewer’s company website. Must be a valid URL if provided.
Error Codes
| Code | HTTP | Description |
|---|---|---|
MISSING_VERIFICATION_ID | 400 | recordVerificationId not provided |
MISSING_NAME | 400 | name not provided |
MISSING_EMAIL | 400 | email not provided |
MISSING_COMPANY | 400 | company not provided |
INVALID_EMAIL | 400 | Email format is invalid |
INVALID_WEBSITE | 400 | Website is provided but not a valid URL |
DUPLICATE_REVIEWER_EMAIL | 409 | Email already used as endorser for the same source |
INTERNAL_ERROR | 500 | Unexpected 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"
}
{
"success": false,
"error": {
"code": "DUPLICATE_REVIEWER_EMAIL",
"message": "This email is already used as an endorser for the same source."
}
}