Sharing & Verification

Every award on badges.ninja has a public verification page that anyone can access without signing in. Recipients can share their badges on social media, by email, or by copying a direct link.

Recipients have their own portal too

If you've earned a badge through badges.ninja, you can sign in (no password needed) at badges.ninja/me to see all your badges in one place and curate a public profile at badges.ninja/u/<your-handle>. See Recipient Portal.

Public Award Page

Each award has a public URL:

https://badges.ninja/awards/{guid}

This page displays the badge image (loaded from IPFS), the badge name and description, the recipient name, the issuer name and logo, the issue date and any expiration date, and the criteria the recipient met to earn the badge. Anyone with the link can open the page to confirm the credential is authentic.

If the issuer set a LinkedIn organization ID, the Add to LinkedIn profile button appears so the recipient can save the credential straight into their LinkedIn Licenses & Certifications. The Download Badge button serves the original badge image (straight from IPFS), and Download PDF generates a printable A4 certificate on the fly.

Public Share Page

The share page provides social sharing options:

https://badges.ninja/awards/{guid}/share

From this page, recipients can share their badge on:

• LinkedIn — posts to their LinkedIn feed, or adds the credential directly to their profile via the Add to LinkedIn Profile button (when the issuer has set a LinkedIn organization ID)
• Twitter / X — posts a tweet with the badge link and custom share text
• Facebook — shares on their Facebook timeline
• WhatsApp — sends a message with the badge link
• Telegram — sends a message with the badge link
• Send Email — opens an in-page modal that delivers a styled email to one or many recipients (see Email Sharing below)
• Copy Link — copies the verification URL to the clipboard
• Embed snippets — copy ready-to-paste <img> and <iframe> HTML to drop the badge into a website, intranet, or email signature

QR Verification

A dedicated verification page renders a scannable QR code pointing at its own URL — perfect for printed certificates, event banners, or LinkedIn screenshots.

https://badges.ninja/verify/{guid}

Anyone scanning the QR with a phone camera lands on the live verification page, where they can confirm the badge is hosted on badges.ninja, follows the Open Badge v2.0 spec, and (on the Pro plan) is anchored on-chain via Matchain. The recipient identity is shown as a SHA-256 hash so emails are never exposed publicly.

PDF Certificate

Every award has a Download Certificate button on the public verification page. Clicking it generates a print-ready A4 PDF on the fly that includes the badge image, recipient name, issuer, criteria, issue date, optional expiration, and a QR code linking back to the live verification URL.

Social Media Previews

When a badge link is shared on LinkedIn, X, Slack, Facebook, WhatsApp, or email, the platform fetches the share endpoint and renders a rich card from the Open Graph metadata badges.ninja emits:

• Badge image as the preview image
• Badge name as the title
• Issuer name and recipient name in the description

This ensures badges look professional when shared anywhere — recipients don't have to attach their own image or write copy. The preview is generated server-side at /certify-badge/award/{guid}/share-html and cached at the CDN edge, so previews appear instantly even on the first share.

Email Sharing

You can send badge awards by email in two ways:

From the Public Share Page

Recipients can share their badge with friends, mentors, or potential employers by clicking Send Email on the share page. A modal opens where they enter one or more email addresses, an optional subject, and a personal message:

Each addressee receives a styled HTML email with the recipient's personal message and a one-click button to view the public award page:

From the Dashboard

Issuers can send any award by email from the Awards page in the dashboard:

1. Find the award on the Awards page.
2. Click the Send button on the row, or open the detail modal and click Resend email.
3. Enter the recipient email and send.

The same email template is used for both flows.

Open Badge v2.0 JSON Endpoints

For interoperability with other badge platforms, badges.ninja provides standard Open Badge v2.0 JSON at these public endpoints:

Endpoint	Description
/certify-badge/issuer/{guid}	Issuer profile JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (the award)

These endpoints return JSON-LD compliant with the Open Badge v2.0 specification. Other badge platforms and verifiers can consume this data to validate credentials.

Example — verify an award:

curl https://api.badges.ninja/certify-badge/award/abc123-def456

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

IPFS Image URLs

Badge images are pinned to IPFS (the InterPlanetary File System) through our own gateway, ipfs.ninja. This means:

• Images are permanent and content-addressed — they cannot be tampered with or silently replaced
• Image URLs in the Open Badge JSON look like https://ipfs.ninja/ipfs/{cid}
• The same content-ID resolves through any public IPFS gateway (cloudflare-ipfs.com, ipfs.io, etc.) — your badges are not locked to a single provider

Because the image is part of the Open Badge assertion, replacing the badge artwork later does not break previously-issued awards: the old IPFS CID stays resolvable forever, so historical awards keep their original image even if you redesign the badge for new issuances.