Skip to main content

Phone Number Validation

Requirements
  • API key pair
  • Service enabled (done by iDenfy's staff)
  • Number validation credits
Image alt text

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

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. ""

KeyRequiredTypeConstraintsExplanation
phone_numberYesString- E.164 formatPhone number with country code to check
current_locationNoString- Country alpha-2 codeCurrent 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"
}