v1

latestOpenAPI 3.1.02026-08-0653126213.6 KB
Badge Assertion

Verify Badge Assertion

Public endpoint — no authentication required. Any user (logged in or not) may check verification status of a badge assertion.

Verify a badge assertion against Open Badge criteria: the assertion is Claimed, the issue date exists and is in the past, the issuer is active, the recipient name matches the linked account (fuzzy), a claim date exists and post-dates the issue date, and the assertion has been updated after the claim date.

time_verified reflects the current state: set when all criteria pass and cleared when any fail. The website renders a green tick next to the recipient avatar while it is set, so the flag must follow the live verification result rather than stick on the first success.

Returns 403 for non-public assertions (e.g. Pending).

get/v1/badge_assertion/{badge_assertion_id}/verify

Path parameters

badge_assertion_idinteger required

Response

Successful Response

verifiedboolean
reasonsobject
status'Pending' | 'Claimed' | 'Expired' | 'Revoked' | 'Deleted' | 'Failed' | 'Complained'
issue_datestring date-time nullable
issuer_verifiedboolean nullable
issuing_method'Email' | 'Activity' | 'Autobadge' | 'Bulk' | 'API' | 'Pushed' | 'Migrated' | 'QR' | 'Library_Card' | 'Riddle' | 'Typeform' | 'Zoho_Forms' | 'Tally' | 'Imported' | 'Pathway'
recipient_namestring nullable
issuer_namestring nullable
source_platformstring nullable
time_createdstring date-time nullable
time_claimedstring date-time nullable
time_updatedstring date-time nullable