Webhook events
Every event MYIDII sends, and what's inside.
Every event has the same envelope:
{
"id": "evt_...",
"object": "event",
"type": "session.completed",
"environment": "live",
"created_at": "2026-11-16T20:16:37.000Z",
"data": { }
}Requests carry two headers: MYIDII-Signature, to verify, and
MYIDII-Delivery, a unique id for that delivery.
| Event | When | data |
|---|---|---|
session.completed | A check is decided, passed or failed | The session object |
session.expired | A link ran out before the scan finished | The session object |
wallet.low_balance | A live check took the balance below your warning level | currency, balance (in cents) |
wallet.topped_up | A top-up was paid | amount, currency, balance (in cents) |
webhook.test | You chose Send test in the dashboard | A short message |
Wallet events are sent to live endpoints only.