Name Search

Find a person using a first name and last name. Optionally, add a middle name, city, state, or email address to filter further.

Search for a Person by Name

Securityapi_key

Request

query Parameters

first_name required	string The first name of the person you are searching for.
middle_name	string The middle name of the person you are searching for.
last_name required	string The last name of the person you are searching for.
city	string A city associated with the person you are searching for.
state	string A state associated with the person you are searching for.
email	string An email address associated with the person you are searching for.
start_index	string The starting index from which results should be fetched. This is a 1-based index. For example, if there are 10 total results and start_index is set to 3, results from the third item (index 3) through to the tenth item (index 10) will be returned.
end_index	string The ending index up to which results should be fetched. This is a 1-based index. For example, if there are 10 total results and end_index is set to 7, results from the first item (index 1) through to the seventh item (index 7) will be returned.
position_token	string This method facilitates continuous data retrieval in a sequenced manner. If the response has position_token set, use the token obtained from the initial Name Search response as a parameter in the search URL to access the next set of results. Each response is limited to returning a maximum of 50 results.

Responses

200

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

Response Schema: application/json

object

Array of objects

Array

id	string A unique identifier associated with the person. Input this ID into Person ID Search to retrieve person data, including contact information.
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.
age	number The person’s current age or age at death.
	Array of objects Phone numbers associated with the person.
	Array of objects Email addresses associated with the person.
	Array of objects Addresses associated with the person.
relatives	Array of strings Relatives associated with the person.
aliases	Array of strings Aliases associated with the person.
address_count	number The total number of addresses associated with the person.
is_deceased	boolean A value of "true" signifies that the person is deceased, while "false" signifies that the person is alive.

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.

404

Not Found

get/names

Request samples

curl --header "X-api-key: [YOUR API KEY]" \
  -X GET 'https://api.spokeo.com/v4/names?first_name=john&last_name=smith&state=california'

Response samples

application/json

{"data": {"people": [{"id": 1234567890,
"first_name": "John",
"last_name": "Doe",
"middle_name": "U",
"full_name": "John U Doe",
"age": 30,
"phones": [{"phone": 5551234567,
"chronology_rank": 1
}
],
"emails": [{"email": "username@email.com",
"chronology_rank": 1
}
],
"addresses": [{"city": "Anytown",
"state": "CA",
"street_address": "123 Main St",
"postal_code": 11111,
"latitude": 40.689247,
"longitude": -74.0451471
}
],
"relatives": ["Jane Doe"
],
"aliases": ["John K Doe"
],
"address_count": 10,
"is_deceased": false
}
]
},
"metadata": {"total_people_count": 200
},
"position_token": null
}

➔ Next to Phone Search