Store Verification Items

curl -X POST https://api.yourservice.com/api/v1/step3/store-verification-items/store \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "sessionToken": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "projectIds": ["proj_001", "proj_002"],
    "workExperienceIds": [],
    "credentialIds": ["cert_001"]
  }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "recordUserId": "usr_live_xyz789",
    "stored": {
      "projects": [
        {
          "recordProjectId": "uuid-proj-1",
          "externalProjectId": "proj_001",
          "projectName": "E-Commerce App"
        }
      ],
      "experience": [],
      "certificates": [
        {
          "recordCertificateId": "uuid-cert-1",
          "externalCertificateId": "cert_001",
          "certificateName": "AWS Certified Developer"
        }
      ]
    }
  },
  "message": "Verification items synced successfully"
}

POST

step3

store-verification-items

store

curl -X POST https://api.yourservice.com/api/v1/step3/store-verification-items/store \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "sessionToken": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "projectIds": ["proj_001", "proj_002"],
    "workExperienceIds": [],
    "credentialIds": ["cert_001"]
  }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "recordUserId": "usr_live_xyz789",
    "stored": {
      "projects": [
        {
          "recordProjectId": "uuid-proj-1",
          "externalProjectId": "proj_001",
          "projectName": "E-Commerce App"
        }
      ],
      "experience": [],
      "certificates": [
        {
          "recordCertificateId": "uuid-cert-1",
          "externalCertificateId": "cert_001",
          "certificateName": "AWS Certified Developer"
        }
      ]
    }
  },
  "message": "Verification items synced successfully"
}

Overview

Stores the source items the student has selected as the basis for their skill verification. Items are upserted against the session — items previously stored but not included in the new request are automatically deleted (replace-on-submit behaviour).

Prerequisite: Step 2 (verification method) must be completed before calling this endpoint. Requests are rejected with VERIFICATION_METHOD_NOT_SET if Step 2 is missing.

The IDs you pass must match items submitted during POST /verify. The session (stored in Redis) contains the full data for each item — the endpoint looks up each ID and writes the full details to the database.

Request Body

string

required

Session token returned from POST /verify.

string[]

IDs of projects from the session to attach. Defaults to [].

string[]

IDs of work experiences from the session to attach. Defaults to [].

string[]

IDs of certificates from the session to attach. Defaults to [].

At least one of projectIds, workExperienceIds, or credentialIds must be non-empty.

Response

boolean

true on success.

object

Show Response fields

string

The verification session ID.

string

The internal user ID.

object

Contains projects, experience, and certificates arrays with stored item details.

Error Codes

Code	HTTP	Description
`MISSING_SESSION_TOKEN`	400	`sessionToken` not provided
`NO_ITEMS_SELECTED`	400	All three arrays are empty
`SESSION_NOT_FOUND`	404	Session token is expired or invalid
`VERIFICATION_METHOD_NOT_SET`	400	Step 2 has not been completed
`DUPLICATE_SKILLS_IN_BUNDLE`	409	Skills already verified for this source under same endorsement type
`MAX_SKILLS_PER_SOURCE`	409	Would exceed the 10-skill limit for this source
`ASSESSMENT_ALREADY_PASSED`	409	Skill already assessment-verified and passed
`INTERNAL_ERROR`	500	Unexpected server error

curl -X POST https://api.yourservice.com/api/v1/step3/store-verification-items/store \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "sessionToken": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "projectIds": ["proj_001", "proj_002"],
    "workExperienceIds": [],
    "credentialIds": ["cert_001"]
  }'

{
  "success": true,
  "data": {
    "recordVerificationId": "ver_live_abc123",
    "recordUserId": "usr_live_xyz789",
    "stored": {
      "projects": [
        {
          "recordProjectId": "uuid-proj-1",
          "externalProjectId": "proj_001",
          "projectName": "E-Commerce App"
        }
      ],
      "experience": [],
      "certificates": [
        {
          "recordCertificateId": "uuid-cert-1",
          "externalCertificateId": "cert_001",
          "certificateName": "AWS Certified Developer"
        }
      ]
    }
  },
  "message": "Verification items synced 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