Credentials
Magic-link claim
The LearnCoin email-based flow where recipients receive a one-time link that binds the credential to their email and marks it claimed.
The magic-link claim flow is how LearnCoin's default credential-delivery model works. After a tenant issues a credential via POST /v1/batches, LearnCoin emails the recipient a one-time link that — when clicked — binds the pseudonymous credential subject to the recipient's email and marks the credential's [claim_state](/glossary/claim-state) as claimed.
The link is cryptographically signed and scoped to a specific credential ID. It expires after a configurable window (default 30 days) and can only be used once. Replay is prevented at the database level. If the recipient misses the window, the tenant can resend via POST /v1/credentials/<id>/resend-claim.
Ewance's operational data from early 2026 shows about 60% of recipients click magic links — consistent with industry benchmarks. Tenants with pre-authenticated relationships (recipient email already verified by the tenant) can opt into auto-claim to skip the roundtrip entirely.
Related terms