Phone Verification

Verify phone number ownership by sending an SMS or call verification code via the iDenfy API for customer identity and fraud checks.

Requirements

• API key pair
• Service enabled (done by iDenfy staff)
• Number verification credits

Learn More

Verify identity seamlessly using phone number OTP — fast verification for genuine users (under 30 seconds), global coverage, 2FA security, and automated onboarding.

---

Step 1: Send SMS with Verification Code

Authorization: API key pair Method: POST Endpoint: https://ivs.idenfy.com/fraud/send-sms

Calling this endpoint sends an SMS message containing a verification code to your user.

Request Structure

Key	Required	Type	Constraints	Default	Explanation
phone_number	Yes	String	E.164 format	—	Phone number with country code to receive the verification code via SMS
sender_name	No	String	Max length 11	iDenfy	Name or number displayed as the sender

Response Structure

Key	Type	Explanation
request_id	String	You will need this for the verification step

Request

{
  "phone_number": "[phone]",
  "sender_name": "The Sender"
}

Response

{
  "request_id": "3d50e1584e0946e789e0185c009aaadf"
}

Example SMS message sent to your user:

The Sender code: 1234. Valid for 5 minutes.

---

Step 2: Verify User-Entered Code

Authorization: API key pair Method: POST Endpoint: https://ivs.idenfy.com/fraud/verify-sms

After you send the verification code, your user enters the code they received and you verify whether it is valid.

Request Structure

Key	Required	Type	Constraints	Explanation
request_id	Yes	String	Min length 32, Max length 40	The request_id returned from the SMS sending endpoint
received_code	Yes	String	Length 4	Numerical verification code entered by the user

Response Structure

Key	Type	Explanation
is_verified	Bool	true if the code was valid. false if the code was invalid, already validated, or the wrong code was provided too many times.

Request

{
  "request_id": "3d50e1584e0946e789e0185c009aaadf",
  "received_code": "1234"
}

Response

{
  "is_verified": true
}