Clerk API (unofficial showcase)
GET/sessions/{session_id}/reverifications/{reverification_id}

Retrieve a reverification

Retrieve a reverification scoped to a session. A resource server can use this to validate a reverification id it received from its client: confirm it is real, scoped to the expected session, completed, and how fresh each factor is. Single-use / replay detection is the caller's responsibility (the id is stable, so the caller dedups consumed ids).

2 parameters
session_idstringrequired
The ID of the session the reverification belongs to
reverification_idstringrequired
The ID of the reverification

4 status codes
200Success
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:reverification
idstringrequired
session_idstringrequired
user_idstringrequired
levelstringrequired
The level used for the reverification
Allowed:first_factorsecond_factormulti_factor
statusstringrequired
Allowed:needs_first_factorneeds_second_factorcomplete
first_factor_verified_atintegerrequired
Unix timestamp (ms) of the first factor verification, or null if not verified.
second_factor_verified_atintegerrequired
Unix timestamp (ms) of the second factor verification, or null if not verified.
created_atintegerrequired
Unix timestamp of creation.
updated_atintegerrequired
Unix timestamp of last update.
400Request was not successful
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Authentication invalid
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Resource not found
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned: Request was not successful. A 401 is returned: Authentication invalid. A 404 is returned: Resource not found.