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

​
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

​
recordUserId
string
required
The internal user ID of the student, returned from POST /verify.

​
Response

​
success
boolean
true on success.
​
data
array
Array of skill verification records, sorted most-recent first.

​
Skill Status Values

StatusverifiedDescription
verifiedtrueEndorsed by reviewer or passed assessment
rejectedfalseDeclined by reviewer or assessment failed
pendingfalseVerification initiated but not yet completed

​
Error Codes

ConditionHTTPDescription
recordUserId missing400{ "success": false, "message": "recordUserId is required" }
Signature verification fails401 / 403Handled by verifySignature middleware
Unexpected server error500{ "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"
    }
  ]
}