v1

latestOpenAPI 3.1.02026-08-0666136.4 KB
Person ID Search

Search for a Person by Person ID

get/person_id/{id}

Path parameters

idnumber required

unique person identifier

Response

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

metadataobject

Example response

{
  "data": {
    "person": {
      "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": {
        "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": [
        {
          "state": "PA",
          "street_address": "123 Main St",
          "city": "Anytown",
          "county": "Allegheny",
          "latitude": 40.689247,
          "longitude": -74.0451471,
          "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
        }
      ],
      "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": [
        {
          "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,
          "start_date": "2020-01-01",
          "end_date": "2023-12-31"
        }
      ],
      "phone_record_delta_count": 2,
      "relatives": [
        {
          "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,
          "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": [
        {
          "start_date": "2003-04-28",
          "end_date": "2003-04-28",
          "company_name": "Company Name Inc",
          "title": "Software Engineer"
        }
      ],
      "schools": [
        {
          "name": "Anytown University",
          "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": [
            {
              "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"
          }
        }
      ]
    }
  }
}