Download OpenAPI description
Overview
Languages
Servers
https://api.spokeo.com/v5/

Person Data Overview

Person Data FieldTotal CountFill Rate
person.id465,240,211100.00%
person.names465,240,211
person.names.first_name975,522,850100.00%
person.names.middle_name703,815,79880.82%
person.names.last_name975,522,850100.00%
person.names.full_name975,522,850100.00%
person.names.suffix43,440,3606.93%
person.names.name_type975,522,850
person.gender451,923,90297.14%
person.birth.dob_month421,477,97890.59%
person.birth.dob_year435,542,86293.62%
person.death.is_deceased28,920,0446.22%
person.death.death_month28,283,3606.08%
person.death.death_year28,283,3606.08%
person.death.death_age28,283,3606.08%
person.marital_status180,440,87638.78%
person.divorce.divorce_month329,5900.07%
person.divorce.divorce_year329,5900.07%
person.marriage.marriage_month8,030,3061.73%
person.marriage.marriage_year8,030,3061.73%
person.addresses.is_current2,763,486,91898.81%
person.addresses.state2,763,486,91898.81%
person.addresses.street_address2,763,486,60498.81%
person.addresses.city2,763,486,91898.81%
person.addresses.county2,763,486,31898.81%
person.addresses.latitude2,763,359,57098.81%
person.addresses.longitude2,763,359,57098.81%
person.addresses.zip2,763,486,91898.81%
person.addresses.property.zoned_use2,186,773,33995.10%
person.addresses.property.use_type1,755,413,74491.59%
person.addresses.property.market_value1,533,206,47888.02%
person.addresses.property.last_sold_date1,611,956,32788.63%
person.addresses.property.living_area1,639,137,00289.00%
person.addresses.property.bath_total_count1,405,257,25482.76%
person.addresses.property.bath_partial_count322,288,58538.15%
person.addresses.property.bed_count1,174,474,72474.93%
person.addresses.property.area_lot1,604,744,21589.14%
person.addresses.property.year_built1,624,655,60888.60%
person.addresses.property.ownership_start_date1,629,305,73289.04%
person.addresses.property.last_sold_price1,185,857,34175.66%
person.addresses.property.sellability.retail_score1,618,703,14889.86%
person.addresses.property.source_count1,755,423,52291.59%
person.addresses.property.source_date98.81%
person.addresses.property.owners_count1,712,063,96690.98%
person.addresses.property.valuations.date1,743,387,327
person.addresses.property.valuations.market_value1,743,387,327
person.emails.email1,454,869,59768.63%
person.emails.domain_name1,454,869,59768.63%
person.emails.source_count1,454,869,59768.63%
person.emails.source_date68.63%
person.emails.confidence_score1,454,869,59768.63%
person.emails.is_new191,976,54617.10%
person.social_records6,615,469,13057.63%
person.social_profiles.network_name5,011,103,41557.63%
person.social_profiles.url6,768,643,13357.63%
person.social_profiles.photo_url3,062,722,15049.97%
person.social_profiles.display_name6,615,469,13055.15%
person.social_profiles.last_seen_date6,768,647,30045.83%
person.social_profiles.source_count6,768,647,300
person.phones.phone1,936,335,34986.25%
person.phones.activity_status1,707,860,53086.25%
person.phones.line_type1,936,335,34986.25%
person.phones.city1,936,335,34986.25%
person.phones.state1,936,335,34986.25%
person.phones.listing_type1,936,335,34986.25%
person.phones.carrier1,936,335,34986.25%
person.phones.source_count1,936,335,34986.25%
person.phones.is_valid86.25%
person.phones.reputation.risk_level687,780,45763.00%
person.phones.source_date86.25%
person.phones.time_zone_name1,936,335,34986.25%
person.phones.confidence_score1,936,335,33986.25%
person.phones.start_date1,328,893,61686.25%
person.phones.end_date1,328,893,61686.25%
person.phones.is_new207,515,85819.55%
person.work_history17.30%
person.work_history.is_current9.25%
person.work_history.start_date158,929,33811.03%
person.work_history.end_date113,748,5357.68%
person.work_history.company_name200,532,49616.99%
person.work_history.title188,448,50215.10%
person.schools14.67%
person.schools.name589,545,91114.67%
person.schools.start_date344,636,9427.55%
person.schools.type578,432,17414.60%
person.schools.location475,780,52811.98%
person.schools.majors.name3,211,0818.12%
person.certifications2.29%
person.certifications.name61,306,8682.29%
person.certifications.organization52,452,5052.29%
person.certifications.start_date46,241,9021.80%
person.certifications.end_date32,833,3031.68%
person.languages.language145,140,37031.20%
person.languages.proficiency5,415,6580.56%
person.historical_records36.60%
person.historical_records.record_type3,652,562,05336.60%
person.historical_records.event_year3,625,748,35436.56%
person.historical_records.event_month3,461,209,44536.44%

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": {} }