Authentication API
Server-side credential endpoints
/
Overview
While credential verification happens client-side, you may need server-side APIs for credential issuance and management.
Base URL
https://lemma.id/api/v1
Issue Credential
POST
/credentials/issue
Issue a new credential to a user.
Request
JSON
{
"subject": "ppid_abc123...", // User's PPID
"type": "AccessCredential", // Credential type
"claims": {
"role": "user",
"permissions": ["read", "write"]
},
"expiresIn": 86400 // Seconds until expiration
}
Response
JSON
{
"success": true,
"credential": {
"id": "cred_xyz789...",
"type": ["VerifiableCredential", "AccessCredential"],
"issuer": "did:lemma:...",
"issuanceDate": 1704067200,
"expirationDate": 1704153600,
"credentialSubject": {...},
"proof": {...}
}
}
Verify Credential (Server-Side)
POST
/credentials/verify
Server-side verification (optional - client verification preferred).
Note
Client-side verification is recommended for best performance. Use this endpoint only when server-side verification is required.