Revoke a credential
Ending a credential permanently, and what happens to the copy already on a phone.
POST/v1/credentials/{id}/revoke
Ends the credential permanently and records who did it.
Request
curl -X POST https://api.nomi-tech.com/v1/credentials/cred_…/revoke \
-H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
-H "Content-Type: application/json" \
-d '{ "reason": "membership_cancelled" }'The response is the credential, now in revoked, with revokedAt and revocationReason set. Verification refuses it from that moment — including the public page a third party had already bookmarked, and, for a signed academic credential, the status list a verifier checks without calling us at all.
Revoking many at once
POST /v1/credentials/bulk
curl -X POST https://api.nomi-tech.com/v1/credentials/bulk \
-H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
-H "Content-Type: application/json" \
-d '{
"credentialIds": ["cred_…", "cred_…"],
"action": "revoke",
"reason": "programme_ended"
}'The response says how many were applied and lists the ones that failed, each with its reason — so a run of four hundred does not stop on the first bad row.