Advanced phone verification, enrichment, and score

Fido's API endpoints are quite flexible and you can request a range of services from a single endpoint

One of the possible use cases is Fido Phone

What is Fido Phone?

Fido Phone is a product that combines advanced phone validation, data enrichment, and a specific AI model all based on a single touch point, the phone number.

Request

following an example of a Fido Phone

curl --request POST \
     --url https://api.fido.id/1.0/phone \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: [your_app_key]' \
     --data '
{
     "customer_id": "c426ad68-8987-11ec-a8a3-0242ac120002",
     "claims": [
          "phone"
     ],
     "phone_number": "39349xxxxxxx",
}'

Response

Following an example of the response:

{
  "resolution_id": "...",
  "customer_id":"...",  
  "device_request_time":"...",  
  "claims": [
    "phone", 
  ],  
  "phone": {
    "value": "393494108458",
    "type": "mobile",
    "status": "connected",
    "is_valid": true,
    "country": "US",
    "is_ported": true,
    "original_network": "T-Mobile",
    "current_network": "Verizon",
    "is_roaming": false,
    "has_whatsapp": true,
    "whatsapp_privacy_status": "public",
    "whatsapp_image": "https://avatarfiles.alphacoders.com/185/185358.jpg",
    "score": 649,
    "score_cluster": "good"
  }  
}

RESPONSE

The following fields can be found under the "phone" object

name

type

phone

string

The phone number of the user provided during the API call

ex: 00393381234567

type

string

Indicates the phone type of the phone number provided

ex: mobile

status

string

ex:

connected: indicates that the number is valid and the target handset is currently connected to the network (and reachable)
syntax: the phone number contains invalid characters, typos, or is formally incorrect
invalid: indicates that the number is not currently assigned to any subscriber on the network or otherwise invalid
undetermined: indicates that the connectivity status could not be determined and the connectivity status is unknown. This can be caused by invalid numbers, due to lack of connectivity to the target network operator, or other exceptions and errors

is_valid

?boolean

Indicates if the phone number is valid

ex: true, false, null

country_code

string

The country code of the location of the original network

ex: 33

is_ported

?boolean

Will indicate if the number has been ported from its Original Network to a different Current Network.

ex: true, false, null

ported_times

?int

Will indicate the number of times this phone number changed network operator.

ex: 2, null

first_ported

?string

A string in the format YYYY-MM-DD indicates the first portability event.

ex: 2018-01-03, null

last_ported

?string

A string in the format YYYY-MM-DD indicates the last portability event.

ex: 2018-01-03, null

original_network

string

The network operator that the number was originally assigned to

ex: Vodafone

current_network

string

An arbitrary string specifying the current network operator name of the inspected phone number

ex: TIM

is_roaming

?boolean

Indicates whether the number is currently roaming. The availability of roaming information depends on the mobile network operator

ex: true, false, null

has_whatsapp

?boolean

If the phone number is associated with a WhatsApp profile

ex: true, false, null

whatsapp_privacy_status

string

Indicates if the WhatsApp account is public or private

ex: public, null

whatsapp_image

?string

A public URL containing the WhatsApp profile picture

ex: http://..., null

score

number

A number ranging from 0 to 1000 represents the quality of the phone number

ex: 649

score_cluster

string

A cluster summarizing the quality of the phone number

ex: High

Language
Authentication
Header
Click Try It! to start a request and see the response here!