🔔

Webhooks & Events

KidCash doesn't currently support outbound webhooks, but you can poll for changes or integrate with the celebration signal system used by Apple TV and Vision Pro.

GET/api/v1/celebrate

Check for pending celebration signals

Response

{ "celebration": { "kidSlug": "rafi", "kidName": "Rafi", "kidAvatar": "🐰", "amount": 5.00 } }

One-time read — the signal is deleted after being fetched. Returns null if no pending signal. Used by TV/Vision Pro for real-time celebrations.

POST/api/v1/celebrate-billPublic

Trigger a celebration signal (for bill replay)

Request Body

{ "code": "bill-code-here" }

Public endpoint — bill code acts as authorization. Used by the redemption page's "Replay Celebration" button.

← Allowances & Interest