Skip to main content
Verify Email OTP

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

appId
string
required
verificationId
string<uuid>
required

Body

application/json
code
string
required
Required string length: 6

Response

Email OTP verified successfully

verificationId
string<uuid>
required
appId
string
required
status
enum<string>
required
Available options:
success,
pending,
failed,
expired
stage
enum<string>
required

Enum of granular verification stages

Available options:
success,
failed:otp_failed,
failed:too_many_attempts,
phone_number,
phone_number_otp,
select_institution,
select_verification_method,
pending_verification:email,
pending_verification:manual,
pending_verification:portal,
rejected_verification:email,
rejected_verification:manual,
rejected_verification:portal
territory
string
required
Pattern: ^[A-Z]{2}$
consumerGroup
enum<string>
required

Enum of available consumer groups

Available options:
student,
graduate,
healthcare,
military,
first-responder,
charity-worker,
teacher,
parent,
low-income,
disability
availableMethods
enum<string>[]

Enum of available verification methods

Available options:
portal,
manual,
email,
inbound_email
institutionId
string
institutionName
string
createdAt
string<date-time>
updatedAt
string<date-time>
expiresOn
string<date>

YYYY-MM-DD

beansId
string

Internal Pion user ID.