---
title: "Search for Information on a Phone Number"
method: GET
path: "/phones"
tags: ["Phone Search"]
---

# Search for Information on a Phone Number

`GET /phones`

## 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.net/spokeo/apis/untitled-api.md) · [All operations](https://skmtc.net/spokeo/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spokeo/untitled-api/versions/632a13baca1c/schema)