v1
latestOpenAPI 3.1.02026-08-0666136.4 KBPhone Search
Search for Information on a Phone Number
get/phones
Query parameters
phonestring required
The 10-digit US phone number you are using in your search.
Response
OK - A successful Phone Search returns an array of people associated with a phone number, as well as metadata.
Example response
{
"data": {
"owners": [
{
"age": 62,
"addresses": [
{
"address_id": "123a2bf|October Ln|47||",
"street_address": "123 Main St",
"city": "Anytown",
"country": "United States",
"latitude": 40.689247,
"longitude": -74.0451471,
"state": "MN",
"start_date": "1996-01-12",
"end_date": "2025-01-31"
}
],
"schools": [
{
"name": "Anytown University",
"type": "University",
"location": "Anytown, CA",
"linkedin": "linkedin.com/school/anytown-university",
"facebook": "facebook.com/anytownuniversity",
"twitter": "twitter.com/anytownuniversity",
"website": "anytownuniversity.edu",
"degrees": [
{
"name": "computer science"
}
]
}
],
"emails": [
{
"email": "username@email.com"
}
],
"names": [
{
"full_name": "John Smith",
"first_name": "John",
"last_name": "Smith",
"name_type": "main"
}
],
"relatives": [
{
"full_name": "Jane Smith",
"first_name": "Jane",
"last_name": "Smith"
}
],
"social_profiles": [
{
"profile_photo_url": "https://graph.facebook.com/123/picture?type=large&redirect=true",
"profile_url": "https://www.facebook.com/jsmith"
}
],
"work_history": [
{
"title": "Product Manager",
"company_name": "Spokeo"
}
],
"confidence_score": 34.53,
"death_month": 11,
"death_year": 2010,
"dob_month": 3,
"dob_year": 1943,
"start_date": "1996-01-12",
"end_date": "2025-01-31"
}
],
"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",
"carrier": "Verizon Wireless",
"carrier_type": "Wireless",
"time_zone": "America/Anytown"
},
"reputation": {
"risk_level": "High",
"recent_search_count": 5,
"last_comment_date": "2023-09-04",
"score": 1
}
},
"metadata": {
"total_owner_count": 1
}
}