verify otp code

Check the code the end user typed. A correct code verifies the request once; a second try with the same code answers already_used. A wrong code counts as an attempt (5 per request, 10 per identity per 24 hours). A failed verification is a 422 with data.verified: false and a reason. Needs the update ability.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required

Instance ID

string
required

Verification request ID, as returned by create-otp-request

Body Params
string
required
^[0-9]{6}$

The 6-digit code the user typed.

Responses

401

Unauthorized — invalid or missing bearer token

403

Forbidden — insufficient permissions or account blocked

404

Not found — instance or verification request does not exist or does not belong to you

data.verified is false, with a reason), or the body failed validation (code must be exactly 6 digits).

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json