Gift Status

Live

GET /gifts/{code}/status — the current state of a gift code.

Returns the current state of a gift code: issued, redeemed, revoked, expired, with timestamps and the associated badge or reward amount.

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

Response structure
State transitions
Privacy: who can query what codes
Caching behavior