--- title: "Search for Information on a Phone Number" method: GET path: "/phones" tags: ["Phone Search"] --- # Search for Information on a Phone Number `GET /phones` ## Request - Base URL: `https://api.spokeo.com/v5` - URL: `https://api.spokeo.com/v5/phones` - Auth: API key in header `X-api-key` ## Query parameters - `phone` string, required ## Response `200` OK - A successful Phone Search returns an array of people associated with a phone number, as well as metadata. - Phone - `data` object - `owners` object[] - `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. - `age` number: The person’s current age or age at death. - `additional_phones` object[]: Additional phone numbers associated with the person. - `phone` string: Phone Number associated with the person. - `addresses` object[]: Addresses associated with the person. - `address_id` string: The address id associated with the person. - `street_address` string: The street address associated with the person. - `city` string: The city associated with the person. - `country` string: The country 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 person. - `zip` string: The ZIP code associated with the person. - `start_date` string: The date the phone owner started owning this property. - `end_date` string: The date the phone owner stopped owning this property. - `schools` object[]: Schools the person attended. - `name` string: The name of the school the person attended. - `type` string: The type of school the person attended. (e.g. "University") - `location` string: The location of the school the person attended. - `linkedin` string: The social profile of the school the person attended. - `facebook` string: The social profile of the school the person attended. - `twitter` string: The social profile of the school the person attended. - `website` string: The website of the school the person attended. - `start_date` string: The date the phone owner started attending this school. - `end_date` string: The date the phone owner stopped attending this school. - `degrees` object[]: Degrees the person received. - `name` string: The name of the degree the person received. - `emails` object[]: Email addresses associated with the person. - `email` string: Email associated with the person. - `names` object[]: Names associated with the person. - `full_name` string: Full Name associated with the person. - `first_name` string: First Name associated with the person. - `last_name` string: Last Name associated with the person. - `name_type` string: The name type of this record. - `id` string: A unique Spokeo identifier associated with the person. Input this ID into **[Person ID Search](/apis/openapi/person-id-search)** to retrieve person data, including contact information. - `relatives` object[]: Relatives associated with the person. - `full_name` string: Full Name associated with the person. - `first_name` string: First Name associated with the person. - `last_name` string: Last Name associated with the person. - `social_profiles` object[]: Social profiles associated with the person. - `profile_photo_url` string: The social profile photo url. - `profile_url` string: The social profile url. - `work_history` object[]: Jobs the person held. - `title` string: The job title of the phone owner. - `company_name` string: The company name of the workplace. - `confidence_score` number: The confidence level of the phone owner. - `is_company` boolean: Indicates whether the owner is a person or company. - `is_deceased` boolean: Indicates whether the owner is deceased. - `death_month` number: Owner's death month as a number. - `death_year` number: Owner's death year as a number. - `dob_month` number: The person’s dob month as a number. - `dob_year` number: The person’s dob year as a number. - `start_date` string: The start date of this phone owner. - `end_date` string: The end date of this phone owner. - `area_code_locations` object[] - `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. - `phone_info` 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. - `reputation` object - `risk_level` string: The risk level of the phone number. - `recent_search_count` number: The number of recent searches of this phone number. - `last_comment_date` string: The date of the last comment reported for this phone number. - `is_toll_free_or_erc` boolean: Flag to indicate whether the phone number is toll free or ERC. - `score` number: The reputation score of the phone number. - `metadata` object - `total_owner_count` number: The total count in the array of owners returned based on your search inputs. ## Other responses - `400`: Bad Request --- [API](https://skmtc.dev/spokeo/apis/spokeo-5-api.md) - [All operations](https://skmtc.dev/spokeo/apis/spokeo-5-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spokeo/apis/spokeo-5-api/revisions/ae5285edf19c?raw)