Phone Number Validation

Requirements

• 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

Read more

---

number validation

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

Request structure

correct format

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

Explanation:

Calculated score how risky is phone_number.

Constraints:

• Min 0
• Max 99

country_code| Type: String

Explanation:

Two character country code for phone_number.

Constraints:

• Country alpha-2 code

current_network| Type: String

Explanation:

The full name of the carrier that phone_number is associated with.

Constraints:

current_route| Type: String

Explanation:

The type of network that phone_number is associated with.

Constraints:

Values:

• mobile
• landline
• landline_premium
• landline_tollfree
• virtual
• unknown
• pager

original_network| Type: String

Explanation:

The full name of the carrier that phone_number is associated with.

Constraints:

availability| Type: String

Explanation:

Can you call the phone_number. This is applicable to mobile numbers only.

Constraints:

Values:

• unknown
• reachable
• undeliverable
• absent
• bad_number
• blacklisted

validity| Type: String

Explanation:

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.

Constraints:

Values:

• unknown
• valid
• not_valid
• inferred
• inferred_not_valid

roaming| Type: String

Explanation:

Is phone_number outside its home carrier network.

Constraints:

Values:

• unknown
• roaming
• not_roaming

roaming_country| Type: String

Explanation:

If phone_number is roaming, this is the code of the country phone_number is roaming in.

Constraints:

• Country alpha-2 code

roaming_network_name| Type: String

Explanation:

If phone_number is roaming, this is the name of the carrier network phone_number is roaming in.

Constraints:

request_id| Type: String

Explanation:

The unique identifier for your request.

Constraints:

• 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"
}