Skip to main content
Requirements
  • API key pair
  • Service enabled (done by iDenfy staff)
  • Number validation credits

Learn More

Phone Number Risk Scoring for Instant Validation — receive risk scores, filter invalid numbers, and get detailed phone insights in one call.

​
Validate Phone Number

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

​
Request structure

If the provided phone number is not in E.164 format or it is not a mobile phone number, the server may return an empty string "".
KeyRequiredTypeConstraintsExplanation
phone_numberYesStringE.164 formatPhone number with country code to check
current_locationNoStringCountry alpha-2 codeCurrent IP address location

​
Response structure

KeyTypeConstraintsExplanation
risk_scoreFloatMin 0, Max 99Calculated score indicating how risky the phone number is.
country_codeStringCountry alpha-2 codeTwo character country code for the phone number.
current_networkString—The full name of the carrier the phone number is associated with.
current_routeStringmobile, landline, landline_premium, landline_tollfree, virtual, unknown, pagerThe type of network the phone number is associated with.
original_networkString—The full name of the original carrier for the phone number.
availabilityStringunknown, reachable, undeliverable, absent, bad_number, blacklistedWhether the phone number can be called. Applicable to mobile numbers only.
validityStringunknown, valid, not_valid, inferred, inferred_not_validWhether the number is valid. inferred_not_valid means it could not be determined and is likely invalid. Applicable to mobile numbers only.
roamingStringunknown, roaming, not_roamingWhether the phone number is outside its home carrier network.
roaming_countryStringCountry alpha-2 codeIf roaming, the country the phone number is roaming in.
roaming_network_nameString—If roaming, the carrier network the phone number is roaming in.
request_idStringMax length 40The unique identifier for your request.

​
Request example

{
  "phone_number": "+12025550163",
  "current_location": "US"
}

​
Response example

{
  "risk_score": 10.0,
  "country_code": "US",
  "current_network": "United States Premium",
  "current_route": "unknown",
  "original_network": "United States Premium",
  "availability": "unknown",
  "validity": "not_valid",
  "roaming": "unknown",
  "roaming_country": null,
  "roaming_network_name": null,
  "request_id": "fcecf6e6-1ad7-4d5e-98a8-cc9b2d5575eb"
}