curl -X POST https://api.yourservice.com/api/v1/step2/verification-method \
-H "Content-Type: application/json" \
-H "x-api-key: your_api_key_here" \
-d '{
"recordVerificationId": "ver_live_abc123",
"verificationMethod": "human"
}'
{
"success": true,
"data": {
"recordVerificationId": "ver_live_abc123",
"verificationMethod": "human"
},
"message": "Verification method stored successfully"
}
Step 2 — Verification Method
Set Verification Method
Choose between human endorsement or AI assessment for the verification.
POST
/
step2
/
verification-method
curl -X POST https://api.yourservice.com/api/v1/step2/verification-method \
-H "Content-Type: application/json" \
-H "x-api-key: your_api_key_here" \
-d '{
"recordVerificationId": "ver_live_abc123",
"verificationMethod": "human"
}'
{
"success": true,
"data": {
"recordVerificationId": "ver_live_abc123",
"verificationMethod": "human"
},
"message": "Verification method stored successfully"
}
Overview
Stores the endorsement type selected for this verification session. Must be called after Step 1 and before Step 3. The method chosen here determines which path the verification will follow.Requires a valid session token via the
x-api-key session middleware.Request Body
string
required
Verification session ID returned from
POST /verify.string
required
The endorsement type. Accepted values:
human— A reviewer will endorse the student’s skills via email.assessment— An AI will generate questions for the student to answer.
Response
boolean
true on success.object
Error Codes
| Code | HTTP | Description |
|---|---|---|
MISSING_VERIFICATION_ID | 400 | recordVerificationId not provided |
MISSING_VERIFICATION_METHOD | 400 | verificationMethod not provided |
INVALID_VERIFICATION_METHOD | 400 | Value is not human or assessment |
INTERNAL_ERROR | 500 | Unexpected server error |
curl -X POST https://api.yourservice.com/api/v1/step2/verification-method \
-H "Content-Type: application/json" \
-H "x-api-key: your_api_key_here" \
-d '{
"recordVerificationId": "ver_live_abc123",
"verificationMethod": "human"
}'
{
"success": true,
"data": {
"recordVerificationId": "ver_live_abc123",
"verificationMethod": "human"
},
"message": "Verification method stored successfully"
}