Certificates (NFTs)

Upon completing 100% of a course or learning path, learners are eligible to claim a verifiable on-chain completion certificate (ERC-721 / ERC-1155).

Get User Certificates

Returns all certificates issued to or claimed by the user.

Endpoint

GET /api/v2/certificates

Headers

Authorization: Bearer <jwt_access_token>

Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "cert-uuid-1",
      "courseId": "7a3e9c12-3456-4abc-8def-1234567890ab",
      "courseTitle": "Solidity Smart Contract Development",
      "studentName": "John Doe",
      "issuedAt": "2026-08-20T14:30:00.000Z",
      "certificateNumber": "LW-2026-9812",
      "nftTokenId": "104",
      "transactionHash": "0x4a9b...71c2",
      "viewUrl": "https://learnway.xyz/certificates/LW-2026-9812",
      "metadataUri": "ipfs://QmXyz..."
    }
  ]
}

Claim Certificate

Initiates gasless on-chain minting of the completion certificate.

Endpoint

POST /api/v2/certificates/claim

Request Body

{
  "courseId": "7a3e9c12-3456-4abc-8def-1234567890ab",
  "studentName": "Johnathan Doe"
}

Response (201 Created)

{
  "success": true,
  "data": {
    "certificateId": "cert-uuid-1",
    "certificateNumber": "LW-2026-9812",
    "status": "MINTING",
    "message": "Certificate minting has been queued on Lisk L2."
  }
}