Skip to main content
GET
Check verification status

Description

/auth/verification-status Description: Check whether the account for an email address has been verified, and what the next onboarding step is. Used by the signup screen while it waits for the user to click the verification link. This is a public endpoint (no authentication required). It does not reveal whether an address has an account: an address with no account gets exactly the same response as an unverified one (isVerified: false, nextStep: verify_email). Rate limited per client IP (30 requests per 60 seconds). Polling every few seconds stays well within the limit. Method: GET Query Parameters:
  • email (required) - The email address to check
Response: isVerified and a nextStep indicator (verify_email, complete_profile, or login).

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Query Parameters

email
string<email>
required

The email address to check verification status for

Response

Verification status retrieved successfully (also returned for an address with no account)

status
string
Example:

"success"

message
string
Example:

"Verification status retrieved"

data
object