Skip to main content
POST
/
api
/
v3
/
verifications
/
email-verification
/
verify
Verify Email Verification Message
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/email-verification/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "otp": "<string>",
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}"
}
'
{
  "success": true,
  "message": "Email verification processed successfully",
  "data": {
    "status": "VERIFIED",
    "attempt": 2
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}",
  "verificationType": "email_verification",
  "metadata": null
}

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

Accept
string
default:application/json
Content-Type
string
default:application/json

Body

application/json
email
string<email>
required

Email address to send the verification code to.

otp
string
required

One-time passcode sent to the email. Must be a string (for example "123456"), not a number.

trustFlowId
integer
required

Trust flow identifier.

trustValidationId
string
required

Trust validation identifier.

Response

200 - application/json

Email verification completed successfully

Successful email verification response (v3).

type
string

Verification type discriminator.

Example:

"verification.email_verification"

success
boolean
message
string
data
object
verificationStatus
string
verificationStatusCode
integer
trustFlowId
integer

Trust flow identifier.

trustValidationId
string
verificationType
string
Example:

"email_verification"

metadata
object