---
title: "Verify Badge Assertion"
method: GET
path: "/v1/badge_assertion/{badge_assertion_id}/verify"
tags: ["Badge Assertion"]
---

# Verify Badge Assertion

`GET /v1/badge_assertion/{badge_assertion_id}/verify`

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).

## Path parameters

- `badge_assertion_id` integer, required

## Response `200`

Successful Response

- BadgeAssertionVerifyResult
  - `verified` boolean
  - `reasons` object
  - `status` 'Pending' | 'Claimed' | 'Expired' | 'Revoked' | 'Deleted' | 'Failed' | 'Complained'
  - `issue_date` string, date-time, nullable
  - `issuer_verified` boolean, nullable
  - `issuing_method` 'Email' | 'Activity' | 'Autobadge' | 'Bulk' | 'API' | 'Pushed' | 'Migrated' | 'QR' | 'Library_Card' | 'Riddle' | 'Typeform' | 'Zoho_Forms' | 'Tally' | 'Imported' | 'Pathway'
  - `recipient_name` string, nullable
  - `issuer_name` string, nullable
  - `source_platform` string, nullable
  - `time_created` string, date-time, nullable
  - `time_claimed` string, date-time, nullable
  - `time_updated` string, date-time, nullable

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/navigatr/apis/navigatr-api.md) · [All operations](https://skmtc.net/navigatr/apis/navigatr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigatr/navigatr-api/revisions/4039d06e340b/schema)