---
title: "Search for a Person by Name"
method: GET
path: "/names"
tags: ["Name Search"]
---

# Search for a Person by Name

`GET /names`

#### Supported Query Combinations

##### Queries must satisfy the following conditions:
  1. Provide at least one name:
      - `first_name` or
      - `last_name`

  2. Provide at least one of the following additional fields:
      - the other name (`first_name` or `last_name`, whichever wasn't used in the condition above)
      - `middle_name`
      - `phone`
      - `email`
      - `street`
      - `city`
      - `state`
      - `relative_first_name`
      - `relative_last_name`
      - `age_min`
      - `age_max`
<br /><br />
##### Valid Examples
- `first_name` + `last_name`
- `first_name` + `email`
- `last_name` + `phone`
- `first_name` + `state`
- `first_name` + `city`
- `first_name` + `relative_last_name`
- `last_name` + `middle_name` + `state`
- `first_name` + `city` + `distance`
- `first_name` + `street` + `unit`
- `first_name` + `age_min`
- `last_name` + `age_max`
- `first_name` + `age_min` + `age_max`
<br /><br />
##### Invalid Examples
- `first_name` only
- `last_name` only

## Query parameters

- `first_name` string
- `middle_name` string
- `last_name` string
- `street` string
- `unit` string
- `city` string
- `state` string
- `distance` number
- `email` string
- `phone` string
- `relative_first_name` string
- `relative_last_name` string
- `age_min` integer
- `age_max` integer
- `start_index` string
- `end_index` string
- `position_token` string
- `include_possible_matches` boolean

## Response `200`

OK - A successful Name Search returns an array of people.

- Name
  - `data` object
    - `people` object[]
      - `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.
      - `names` object[] — Names associated with the person.
        - `first_name` string — The person’s first name.
        - `last_name` string — The person’s last name.
        - `middle_name` string — The person’s middle name.
        - `full_name` string — The person’s full name.
        - `suffix` string — The person’s name suffix.
        - `name_type` string — The name type of this record.
      - `age` number — The person’s current age or age at death.
      - `dob_month` number — The person’s dob month as a number.
      - `dob_year` number — The person’s dob year as a number.
      - `is_deceased` boolean — A value of "true" signifies that the person is deceased, while "false" signifies that the person is alive.
      - `phones` object[] — Phone numbers associated with the person.
        - `phone` string — Phone Number associated with the person.
        - `phone_is_new` boolean — Indicates if the phone is new in the data.
        - `phone_is_new_rank_one` boolean — Indicates that the phone has newly become rank 1 (i.e. the current rank is 1 and the previous rank was not 1). Otherwise, this value is null.
      - `emails` object[] — Email addresses associated with the person.
        - `email` string — Email associated with the person.
        - `email_is_new` boolean — Indicates if the email is new in the data.
        - `email_is_new_rank_one` boolean — Indicates that the email has newly become rank 1 (i.e. the current rank is 1 and the previous rank was not 1). Otherwise, this value is null.
      - `addresses` object[] — Addresses associated with the person.
        - `city` string — The city associated with the person.
        - `state` string — The state associated with the person.
        - `street_address` string — The street address associated with the person.
        - `zip` string
        - `latitude` number — The latitude of the address associated with the person.
        - `longitude` number — The longitude of the address associated with the person.
        - `address_is_new` boolean — Indicates if the address is new in the data.
        - `address_is_new_rank_one` boolean — Indicates that the address has newly become rank 1 (i.e. the current rank is 1 and the previous rank was not 1). Otherwise, this value is null.
      - `relatives` object[] — Relatives associated with the person.
        - `names` object[] — Names associated with the relative.
          - `first_name` string — The relative's first name.
          - `last_name` string — The relative's last name.
          - `full_name` string — The relative's full name.
      - `usernames` string[] — Usernames associated with the person.
      - `work_history` object[] — Work history associated with the person.
        - `company_name` string — The name of the company.
        - `title` string — The job title at the company.
        - `location` string — The location of the company.
      - `schools` object[] — Schools associated with the person.
        - `name` string — The name of the school.
        - `type` string — The type of school.
        - `location` string — The location of the school.
      - `phone_record_count` number — The total number of phone records associated with the person.
      - `phone_record_delta_count` number — The total change in the number of phone records associated with the person.
      - `email_record_count` number — The total number of email records associated with the person.
      - `email_record_delta_count` number — The total change in the number of email records associated with the person.
      - `address_count` number — The total number of addresses associated with the person.
      - `address_record_delta_count` number — The total change in the number of address records associated with the person.
      - `relative_count` number — The total number of relatives associated with the person.
      - `username_count` number — The total number of usernames associated with the person.
  - `metadata` object
    - `total_people_count` number — The total count in the array of people returned based on your search inputs.
  - `position_token` string — A token indicating that there are additional results beyond those initially returned. Use the token obtained from the initial Name Search response as a parameter in the search URL to access the next set of results.

## Other responses

- `404` — Not Found

---

[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)