Skip to main content
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

recordVerificationId
string
required
Verification session ID returned from POST /verify.
verificationMethod
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

success
boolean
true on success.
data
object

Error Codes

CodeHTTPDescription
MISSING_VERIFICATION_ID400recordVerificationId not provided
MISSING_VERIFICATION_METHOD400verificationMethod not provided
INVALID_VERIFICATION_METHOD400Value is not human or assessment
INTERNAL_ERROR500Unexpected 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"
}