Get User Skills

curl https://api.yourservice.com/api/v1/metadata/user/usr_live_xyz789 \
  -H "x-api-key: your_api_key_here" \
  -H "x-signature: your_signed_request_signature"

{
  "success": true,
  "data": [
    {
      "skillId": "skill_001",
      "skillName": "React",
      "recordVerificationId": "ver_live_abc123",
      "verified": true,
      "status": "verified",
      "proofUrls": ["https://github.com/user/project"],
      "createdAt": "2025-04-01T10:00:00.000Z"
    },
    {
      "skillId": "skill_002",
      "skillName": "Node.js",
      "recordVerificationId": "ver_live_abc123",
      "verified": false,
      "status": "rejected",
      "proofUrls": [],
      "createdAt": "2025-04-01T10:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "data": []
}

GET

metadata

user

{recordUserId}

curl https://api.yourservice.com/api/v1/metadata/user/usr_live_xyz789 \
  -H "x-api-key: your_api_key_here" \
  -H "x-signature: your_signed_request_signature"

{
  "success": true,
  "data": [
    {
      "skillId": "skill_001",
      "skillName": "React",
      "recordVerificationId": "ver_live_abc123",
      "verified": true,
      "status": "verified",
      "proofUrls": ["https://github.com/user/project"],
      "createdAt": "2025-04-01T10:00:00.000Z"
    },
    {
      "skillId": "skill_002",
      "skillName": "Node.js",
      "recordVerificationId": "ver_live_abc123",
      "verified": false,
      "status": "rejected",
      "proofUrls": [],
      "createdAt": "2025-04-01T10:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "data": []
}

Overview

A read-only aggregated view across all verifications for the student — including both verified and rejected skills across all sessions. Results are sorted by createdAt descending.

This endpoint uses signature-based authentication via the verifySignature middleware — not a session token. Your server must sign the request using your API secret key.Designed for backend-to-backend use only. Do not call from a browser or mobile client.

Path Parameters

string

required

The internal user ID of the student, returned from POST /verify.

Response

boolean

true on success.

array

Array of skill verification records, sorted most-recent first.

Show Record fields

string

Unique identifier of the skill.

string | null

Human-readable skill name. null if the skill record no longer exists.

string

The verification session this skill record belongs to.

boolean

true if the skill was verified, false if rejected or pending.

string

verified, rejected, or pending.

string[]

Public URLs submitted as proof for this skill.

string

ISO 8601 timestamp of when this record was created.

Skill Status Values

Status	`verified`	Description
`verified`	`true`	Endorsed by reviewer or passed assessment
`rejected`	`false`	Declined by reviewer or assessment failed
`pending`	`false`	Verification initiated but not yet completed

Error Codes

Condition	HTTP	Description
`recordUserId` missing	400	`{ "success": false, "message": "recordUserId is required" }`
Signature verification fails	401 / 403	Handled by `verifySignature` middleware
Unexpected server error	500	`{ "success": false, "message": "..." }`

If the student has no skill verification records, an empty array is returned — this is not an error.

curl https://api.yourservice.com/api/v1/metadata/user/usr_live_xyz789 \
  -H "x-api-key: your_api_key_here" \
  -H "x-signature: your_signed_request_signature"

{
  "success": true,
  "data": [
    {
      "skillId": "skill_001",
      "skillName": "React",
      "recordVerificationId": "ver_live_abc123",
      "verified": true,
      "status": "verified",
      "proofUrls": ["https://github.com/user/project"],
      "createdAt": "2025-04-01T10:00:00.000Z"
    },
    {
      "skillId": "skill_002",
      "skillName": "Node.js",
      "recordVerificationId": "ver_live_abc123",
      "verified": false,
      "status": "rejected",
      "proofUrls": [],
      "createdAt": "2025-04-01T10:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "data": []
}

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

Path Parameters

Response

Skill Status Values

Error Codes

​Overview

​Path Parameters

​Response

​Skill Status Values

​Error Codes

Overview

Path Parameters

Response

Skill Status Values

Error Codes