Skip to main content
POST
/
api
/
v2
/
verification
/
phone-verification-v2
/
verify
Verify SMS Verification Message
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v2/verification/phone-verification-v2/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "otp": "<string>",
  "ref_id": "<string>",
  "country_code": "<string>",
  "phone_number": "<string>",
  "template_id": "{your_trust_flow_id}",
  "verification_id": "{your_created_verification_id}"
}
'
{
  "status": true,
  "message": "OK",
  "result": {
    "reference_id": "3661783EEE8C0104919289F32793C687",
    "sub_resource": "sms",
    "errors": [],
    "status": {
      "updated_on": "2025-07-31T01:20:39.675083Z",
      "code": 200,
      "description": "Delivered to handset"
    },
    "verify": {
      "code_state": "VALID",
      "code_entered": "991903"
    },
    "phone_evaluation_score": 0
  }
}

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.

​
template_id
string
required

Identifier used to categorize or group requests for tracking or reporting.

​
verification_id
string
required

A unique ID used to identify your 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

​
status
boolean
​
message
string
​
result
object