Skip to main content
POST
/
api
/
v3
/
verifications
/
phone-verification
/
verify
Verify SMS Verification Message
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/phone-verification/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "otp": "<string>",
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}"
}
'
{
  "success": true,
  "message": "Phone verification processed successfully",
  "data": {
    "referenceId": "0123456789ABCDEF0123456789ABCDEF",
    "submitTime": "2026-05-14T10:01:00.000Z",
    "status": {
      "code": 200,
      "description": "Verify success"
    },
    "verify": {
      "codeState": "VALID",
      "inputPhoneNumber": "+60182258491"
    }
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}",
  "verificationType": "sms_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
otp
string
required

One-time passcode submitted by the user.

trustFlowId
integer
required

Trust flow identifier used to categorize or group requests for tracking or reporting.

trustValidationId
string
required

Trust validation identifier for the verification request.

ref_id
string

Reference identifier returned by the send step.

country_code
string

Country dialing code (optional if already bound in session context).

phone_number
string

Phone number (optional if already bound in session context).

Response

200 - application/json

SMS verification completed successfully

Successful response after verifying an SMS OTP (v3).

success
boolean
message
string
data
object
verificationStatus
string
verificationStatusCode
integer
trustFlowId
integer
trustValidationId
string
verificationType
string
Example:

"sms_verification"

metadata
object