Phone Lookup API

How It Works

The Phone Lookup API validates phone numbers and provides comprehensive insights, helping you verify whether a phone number is active, valid, and associated with potential risks. This service is crucial for fraud detection, marketing, and communication systems, enabling you to identify high-risk or fraudulent phone numbers before they cause issues.

Key Features:

• Validate phone number status (active or inactive).
• Identifies phone type: wireless, VoIP, or landline.
• Detects high-risk, spammer, leaked, or disposable numbers.
• Provides carrier and location details.
• Includes fraud scoring for risk assessment.

Integration

Endpoint:

api/phonelookup

Method:

POST

Base URL:

https://api.boltidentity.com/

Request Headers:

{
  "licenseKey": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body:

The request must include the phone number to be validated.

{
  "phone": "13132107340"
}

Example Request (Using Fetch):

const response = await fetch('https://api.boltidentity.com/api/phonelookup', {
    method: 'POST',
    headers: {
        'licenseKey': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        phone: "13132107340"
    })
});

const data = await response.json();

Sample Response

{
  "Bolt-Identity": {
    "clientId": "FPC0001",
    "apiService": "phoneLookup",
    "requestType": "Free",
    "report": {
      "referenceID": "fpfr-lhwmzc6kz3",
      "jsonResponse": {
        "phonePulse": {
          "status": "Declined",
          "message": "Phone validation Declined. High risk phone number detected.",
          "response": {
            "isValid": true,
            "isActive": true,
            "isVoip": false,
            "countryCode": "US",
            "dialingCode": 1,
            "formattedNumber": "+13132107340",
            "carrier": "T-Mobile",
            "city": "DETROIT",
            "region": "MI",
            "timeZone": "America/Detroit",
            "lineType": "Wireless",
            "fraudScore": 100,
            "isRisky": true,
            "isSpammer": false,
            "recentAbuse": true,
            "leaked": false,
            "prepaid": false,
            "doNotCall": false,
            "mcc": "310",
            "mnc": "160",
            "zipCode": "48223",
            "name": "N/A",
            "associatedEmails": [],
            "smsDomain": "tmomail.net",
            "smsEmail": "3132107340@tmomail.net"
          }
        }
      },
      "apiKeyUsed": "api-key-1728234535454-4b4i42ur874",
      "requestDateTime": "2025-01-26T10:13:20.352Z"
    },
    "_id": "67960ac0f49dead56388727d",
    "createdAt": "2025-01-26T10:13:20.353Z",
    "updatedAt": "2025-01-26T10:13:20.353Z",
    "__v": 0
  }
}

Understand Response

Field	Description	Possible Values / Example
status	Indicates the overall status of the request.	Verified, Declined
message	Provides additional information about the status.	"Phone validation successful.", "High risk phone number detected."
isValid	Indicates if the phone number is valid.	true, false
isActive	Indicates if the phone number is active.	true, false
isVoip	Specifies if the phone number is associated with VoIP.	true, false
countryCode	The country code of the phone number.	US
dialingCode	The international dialing code.	1
formattedNumber	The phone number in a standardized format.	+13132107340
carrier	The carrier associated with the phone number.	T-Mobile
city	City where the phone number is registered.	DETROIT
region	Region or state of the phone number registration.	MI
timeZone	The time zone of the phone number location.	America/Detroit
lineType	The type of phone line.	Wireless, Landline, VoIP
fraudScore	Risk score for fraud likelihood (0-100).	100
isRisky	Indicates if the phone number is considered high-risk.	true, false
isSpammer	Specifies if the number is associated with spamming.	true, false
recentAbuse	Indicates if the number has been recently abused.	true, false
leaked	Specifies if the number appeared in a data leak.	true, false
prepaid	Indicates if the number is prepaid.	true, false
doNotCall	Indicates if the number is in the Do Not Call registry.	true, false
mcc	Mobile country code.	310
mnc	Mobile network code.	160
zipCode	Zip code of the phone number's registration.	48223
name	Name associated with the phone number, if available.	N/A
associatedEmails	List of emails linked to the phone number.	[]
smsDomain	The SMS domain associated with the carrier.	tmomail.net
smsEmail	The SMS email address for the phone number.	3132107340@tmomail.net