Name Search

Look up person profile based on a first name and last name. Optionally use middle name, city, state, and position token to filter further.

Search for a Person by Name

Securityapi_key

Request

query Parameters

first_name required	string first name of the person
middle_name	string middle name of the person
last_name required	string last name of the person
city	string city in which to search this person
state	string state in which to search this person
email	string search a person by their email
start_index	string start index (1-based) of people results to return.
end_index	string end index (1-based) of people results to return.
position_token	string page/position token of the people response

Responses

200

Response Schema: application/json

Array of objects

Array

id	string Input ID into Person ID Search to obtain person data including contact information
first_name	string
last_name	string
middle_name	string
full_name	string
age	number
phones	Array of strings
emails	Array of strings
	Array of objects
family_members	Array of strings
aliases	Array of objects
address_count	number
is_deceased	boolean

total_result_count

number

position_token

string

412

Precondition Failed

get/names

Request samples

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

Response samples

application/json

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

➔ Next to Phone Search