Overview
Languages
Servers
https://api.spokeo.com/v5/

Search for a Person by Person ID

Request

Path
idnumberrequired

unique person identifier

curl -i -X GET \
  'https://api.spokeo.com/v5/person_id/{id}' \
  -H 'X-api-key: YOUR_API_KEY_HERE'

Responses

OK - A successful Person ID Search returns a Spokeo profile.

Bodyapplication/json
dataobject
data.​personobject
data.​person.​idstring

A unique person identifier.

Example: 1234567890
data.​person.​namesArray of objects
data.​person.​genderstring

The person's gender.

Example: "Male"
data.​person.​birthobject
data.​person.​deathobject
data.​person.​divorceobject
data.​person.​marital_statusstring

The person's marital status.

Example: "Married"
data.​person.​marriageobject
data.​person.​addressesArray of objects

Addresses associated with the person.

data.​person.​address_delta_countnumber

Number of address changes for this person.

Example: 2
data.​person.​emailsArray of objects

Email addresses associated with the person.

data.​person.​email_record_delta_countnumber

Number of email record changes for this person.

Example: 1
data.​person.​social_profilesArray of objects

Social profiles associated with the person.

data.​person.​phonesArray of objects

Phone numbers associated with the person.

data.​person.​phone_record_delta_countnumber

The number of changes made to the phone record.

Example: 2
data.​person.​relativesArray of objects

Relatives associated with the person.

data.​person.​work_historyArray of objects

Jobs the person held.

data.​person.​schoolsArray of objects

Schools the person attended.

data.​person.​certificationsArray of objects

Certifications the person received.

data.​person.​languagesArray of objects

Languages the person speaks.

data.​person.​historical_recordsArray of objects

Historical records of the person.

metadataobject
Response
application/json
{ "data": { "person": { "id": 1234567890, "names": [ { "full_name": "John James Doe Jr.", "first_name": "John", "middle_name": "James", "last_name": "Doe", "suffix": "Jr.", "name_type": "main" } ], "gender": "Male", "birth": { "dob_month": 3, "dob_year": 2000 }, "death": { "is_deceased": true, "death_month": 11, "death_year": 2010, "death_age": 58 }, "divorce": { "divorce_month": 3, "divorce_year": 2025 }, "marital_status": "Married", "marriage": { "marriage_month": 3, "marriage_year": 2020 }, "addresses": [ { "is_current": true, "state": "PA", "street_address": "123 Main St", "city": "Anytown", "county": "Allegheny", "latitude": 40.689247, "longitude": -74.0451471, "zip": 11111, "is_new": true, "is_new_rank_one": true, "street_url_path": "/Main+St+Anytown+CA+addresses", "url_path": "/CA/Anytown/123-Main-St", "property": { "zoned_use": "Single Family Residence", "use_type": "Residential", "market_value": 1776000, "last_sold_date": "2023-09-04", "living_area": 742, "bath_total_count": 2, "bath_partial_count": 1, "bed_count": 3, "area_lot": 742, "year_built": 1952, "ownership_start_date": "2000-01-03", "last_sold_price": 156000, "sellability": { "retail_score": 982 }, "source_count": 2, "source_date": "1996-01-12", "owners_count": 1, "valuations": [ { "date": "2021-11-24", "market_value": 1776000 } ] } } ], "address_delta_count": 2, "emails": [ { "email": "username@email.com", "type": "Commercial", "domain_name": "gmail", "source_count": 1, "source_date": "2023-01-15", "confidence_score": 64.25, "is_new": true, "is_new_rank_one": false } ], "email_record_delta_count": 1, "social_profiles": [ { "network_name": "Twitter", "url": "http://twitter.com/", "photo_url": "https://graph.facebook.com/123/picture?type=large&redirect=true", "display_name": "John Doe", "last_seen_date": "2023-01-15", "source_count": 1 } ], "phones": [ { "phone": 5551234567, "activity_status": "Active", "line_type": "Wireless", "city": "Anytown", "state": "PA", "listing_type": "Unknown", "carrier": "AT&T Mobility", "source_count": 1, "is_valid": true, "reputation": { "risk_level": "Low" }, "source_date": "2023-01-15", "time_zone_name": "America/New_York", "confidence_score": 58.36, "is_new": true, "is_new_rank_one": false, "start_date": "2020-01-01", "end_date": "2023-12-31" } ], "phone_record_delta_count": 2, "relatives": [ { "id": 1234567890, "names": [ { "full_name": "Jane Joan Doe Jr.", "first_name": "Jane", "middle_name": "Joan", "last_name": "Doe", "suffix": "Jr.", "name_type": "main" } ], "dob_month": 5, "dob_year": 1950, "is_deceased": true, "death_year": 2010, "death_month": 11, "gender": "Female", "marital_status": "Married", "addresses": [ { "street_address": "123 Main St", "city": "Anytown", "state": "SC", "start_year": 2000, "start_month": 6, "end_year": 2010, "end_month": 12, "coresidence_start_year": 2005, "coresidence_start_month": 3, "coresidence_end_year": 2015, "coresidence_end_month": 8 } ] } ], "work_history": [ { "is_current": true, "start_date": "2003-04-28", "end_date": "2003-04-28", "company_name": "Company Name Inc", "title": "Software Engineer" } ], "schools": [ { "name": "Anytown University", "start_date": 2025, "type": "post-secondary institution", "location": "Anytown, CA", "majors": [ { "name": "business" } ] } ], "certifications": [ { "name": "certified software engineer", "organization": "some coding school", "start_date": "2020-06", "end_date": "2022-08" } ], "languages": [ { "language": "English", "proficiency": "fluent" } ], "historical_records": [ { "record_type": "census", "event_year": 1996, "event_month": 3, "relatives": [ { "id": 1234567890, "relation_type": "spouse", "names": [ { "full_name": "Jane Joan Doe", "first_name": "Jane", "middle_name": "Joan", "last_name": "Doe", "maiden_name": "Smith" } ] } ], "names": [ { "full_name": "John James Doe", "first_name": "John", "middle_name": "James", "last_name": "Doe", "maiden_name": "Smith" } ], "birth": { "dob_month": 12, "dob_year": 1980, "dob_zodiac": "Sagittarius" }, "death": { "is_deceased": true }, "address": { "city": "Anytown", "location": "Greater Anytown", "state": "CA" } } ] } }, "metadata": {} }