Phone Search

Find people associated with a 10-digit US phone number.

Search for a Person by Phone Number

Securityapi_key

Request

query Parameters

phone

required

string

The 10-digit US phone number you are using in your search.

Responses

200

OK - A successful Phone Search returns an array of people associated with a phone number, as well as metadata.

Response Schema: application/json

object

Array of objects

Array

name	string The person’s full name.
is_current_owner	boolean A value of "true" signifies that the person is the current owner of the phone number, while "false" signifies that the person is either a possible current owner or a previous owner.
id	string A unique identifier associated with the person. Input this ID into Person ID Search to retrieve person data, including contact information.
	Array of objects Additional phone numbers associated with the person.
age	number The person’s current age or age at death.
aliases	Array of strings Aliases associated with the person.
	object Address associated with the person.
	Array of objects Schools the person attended.
	Array of objects Email addresses associated with the person.
previous_locations	Array of strings Previous locations associated with the person.
relatives	Array of strings Relatives associated with the person.
social_profiles	Array of objects Social profiles associated with the person.
work_history	Array of objects Jobs the person held.

Array of objects

Array

city	string The city associated with the person.
latitude	number The latitude of the address associated with the person.
longitude	number The longitude of the address associated with the person.
state	string The state associated with the phone number's area code.

object

activity_status	string Returns whether the phone line is “Active” or “Inactive”.
activity_status_confidence	string The confidence level of the activity status.
line_type	string Returns whether the phone line is “Landline”, “Wireless”, or “VOIP”.
listing_type	string Returns whether the phone service is "Residential", "Business", or "Special Services".
special_service_type	string The type of special service associated with the phone number (e.g. “Information Provider”).
carrier	string The company providing the phone service.
carrier_type	string The type of business for the carrier (e.g. “Wireless”).
is_valid	boolean A value of "true" signifies that the phone number is properly formed and assigned to a carrier.
is_portable	boolean A value of "true" signifies that the phone number can switch carriers.
time_zone	string The time zone associated with the phone number's area code.
spam_risk_level	string The probability that a call from this phone number is spam.

object

total_owner_count

number

The total count in the array of owners returned based on your search inputs.

400

Bad Request

get/phones

Request samples

curl --header "X-api-key: [YOUR API KEY]" \
  -X GET 'https://api.spokeo.com/v4/phones?phone=1234567890'

Response samples

application/json

{"data": {"owners": [{"name": "John Smith",
"is_current_owner": true,
"id": 1234567890,
"additional_phones": [{"phone": 5551234567,
"chronology_rank": 1
}
],
"age": 62,
"aliases": [["John James Smith"
]
],
"current_address": {"street_address": "123 Main St",
"city": "Anytown",
"country": "United States",
"latitude": 40.689247,
"longitude": -74.0451471,
"state": "MN",
"zip": 55555
},
"schools": [{"name": "Anytown University",
"start_date": 2010,
"end_date": 2012,
"degree": "computer science"
}
],
"emails": [{"email": "username@email.com",
"chronology_rank": 1
}
],
"previous_locations": ["Othertown MN"
],
"relatives": ["Jane Smith"
],
"social_profiles": [ ],
"work_history": [ ]
}
],
"area_code_locations": [{"city": "Anytown",
"latitude": 40.689247,
"longitude": -74.0451471,
"state": "CA"
}
],
"phone_info": {"activity_status": "Active",
"activity_status_confidence": "High",
"line_type": "Wireless",
"listing_type": "Unknown",
"special_service_type": null,
"carrier": "Verizon Wireless",
"carrier_type": "Wireless",
"is_valid": true,
"is_portable": true,
"time_zone": "America/Anytown",
"spam_risk_level": "Low"
}
},
"metadata": {"total_owner_count": 1
}
}

➔ Next to Address Search