Badge Lookup

Live

GET /cat721/badge/lookup — find a badge by identifier, email, or program-specific reference.

Lookup resolves a badge from various inputs — badge identifier, member email (hashed), program-specific reference ID — and returns the canonical badge record.

This page is being written.

The structure is fixed. The prose is being drafted from the source material and reviewed by HeartChain Labs before publication. If you need this information urgently, email docs@heartbadge.com .

What this page will cover

Lookup parameters and matching rules
Privacy: what lookups are permitted under what scopes
Handling multiple matches
Response structure
Rate limits on lookup endpoints