Set 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"
}

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

Show Response fields

string

The session ID this applies to.

string

The endorsement method stored — human or assessment.

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"
}

Overview

Skills

Selected Skills

Admin

Skill Verification

Step 1 — Skills

Step 2 — Verification Method

Step 3 — Source Items

Reviewer Details

Human Verification

Assessment Verification

Metadata

Overview

Request Body

Response

Error Codes

​Overview

​Request Body

​Response

​Error Codes

Overview

Request Body

Response

Error Codes