Live on Base with Ewance

See the certificates
Sign in
API ReferenceReferenceCredentials

Revoke a credential

Marks a credential as revoked. The cryptographic proof still verifies, but the public verification page shows `Status: Revoked`. Revocation is independent of erasure.

POST
/credentials/{id}/revoke

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token in the Authorization header. Key prefix determines environment: lrn_test_ → Base Sepolia, lrn_live_ → Base mainnet.

In: header

Path Parameters

id*string
Match^crd_[A-Z0-9]{26}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.learncoin.me/v1/credentials/crd_01HXYZABCDEF1234567890ABCD/revoke" \  -H "Content-Type: application/json" \  -d '{    "reason": "string",    "reason_code": "reissued"  }'
{
  "id": "string",
  "revoked": true,
  "revoked_at": "2019-08-24T14:15:22Z",
  "reason": "string",
  "reason_code": "string"
}
{
  "error": {
    "code": "credential_not_found",
    "message": "string",
    "request_id": "req_01HXYZABCDEF"
  }
}
{
  "error": {
    "code": "credential_not_found",
    "message": "string",
    "request_id": "req_01HXYZABCDEF"
  }
}
{
  "error": {
    "code": "credential_not_found",
    "message": "string",
    "request_id": "req_01HXYZABCDEF"
  }
}

Retrieve a credential

Returns the credential's current status plus the signed JSON-LD document (same artifact consumed by the public `/c/{id}` verification page and by any Blockcerts-compatible verifier).

GDPR erasure

Honor a recipient's GDPR right-to-be-forgotten request. Redacts recipient PII from the off-chain store. The on-chain anchor and cryptographic proof are not affected — the credential remains verifiable.