Skip to Content
MYIDIIDocs

Errors

What each error means and what to do about it.

Errors come back with an HTTP status and a body like this:

{ "error": { "type": "insufficient_funds", "message": "Your wallet balance is too low for a live check. Top up in the dashboard." } }

Match on type. The message is written for people and may change.

StatusTypeMeaning
400invalid_requestSomething in the request is wrong. The message says what
401authentication_requiredNo key was sent. Use Authorization: Bearer sk_...
401invalid_keyThe key doesn't exist or was revoked
401wrong_keyThat's a publishable key. Use a secret key, from your server
402insufficient_fundsThe wallet can't cover a live session. Top up
403domain_unverifiedLive keys only work while your company domain is verified
404not_foundNo session with that id for this key's environment
404no_photoThe session has no photo. Only passed live checks do

@myidii/node throws these as a MyidiiError, with the same type and status.

If the liveness engine is briefly unavailable while someone is scanning, the scan page asks them to try again in a minute. That happens on the page, not in your API calls, and their session stays open.