Phone Number Validation
- API key pair
- Service
enabled(done by iDenfy's staff) - Number validation credits
Phone Number Risk Scoring for Instant Validation
- Receive phone risk score via API
- Filter invalid numbers, identify risky customers
- Get detailed phone insights in one call
Authorization: API key pair
Method: POST
Endpoint: https://ivs.idenfy.com/fraud/validate-phone
Request structure
If the provided phone number in the request is not in E.164 format or it's not a mobile phone number, our servers may return an empty string. ""
| Key | Required | Type | Constraints | Explanation |
|---|---|---|---|---|
phone_number | Yes | String | - E.164 format | Phone number with country code to check |
current_location | No | String | - Country alpha-2 code | Current IP address location |
Response structure
risk_score| Type: Float
Calculated score how risky is phone_number.
- Min 0
- Max 99
country_code| Type: String
Two character country code for phone_number.
- Country alpha-2 code
current_network| Type: String
The full name of the carrier that phone_number is associated with.
current_route| Type: String
The type of network that phone_number is associated with.
Values:
- mobile
- landline
- landline_premium
- landline_tollfree
- virtual
- unknown
- pager
original_network| Type: String
The full name of the carrier that phone_number is associated with.
availability| Type: String
Can you call the phone_number. This is applicable to mobile numbers only.
Values:
- unknown
- reachable
- undeliverable
- absent
- bad_number
- blacklisted
validity| Type: String
inferred_not_valid means that the number could not be determined as valid or invalid via an external system and the best guess is that the number is invalid. This is applicable to mobile numbers only.
Values:
- unknown
- valid
- not_valid
- inferred
- inferred_not_valid
roaming| Type: String
Is phone_number outside its home carrier network.
Values:
- unknown
- roaming
- not_roaming
roaming_country| Type: String
If phone_number is roaming, this is the code of the country phone_number is roaming in.
- Country alpha-2 code
roaming_network_name| Type: String
If phone_number is roaming, this is the name of the carrier network phone_number is roaming in.
request_id| Type: String
The unique identifier for your request.
- Max length 40
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"
}