--- title: "Search for a Person by Person ID" method: GET path: "/person_id/{id}" tags: ["Person ID Search"] --- # Search for a Person by Person ID `GET /person_id/{id}` ## Request - Base URL: `https://api.spokeo.com/v5` - URL: `https://api.spokeo.com/v5/person_id/{id}` - Auth: API key in header `X-api-key` ## Path parameters - `id` number, required ## Response `200` OK - A successful Person ID Search returns a Spokeo profile. - Person - `data` object - `person` object - `id` string: A unique person identifier. - `names` object[] - `full_name` string: The person's full name. - `first_name` string: The person's first name. - `middle_name` string: The person's middle name. - `last_name` string: The person's last name. - `suffix` string: The person's suffix. - `name_type` string: The name type of this record. - `gender` string: The person's gender. - `birth` object - `dob_month` number: The month of the person's birth. - `dob_year` number: The year of the person's birth. - `death` object - `is_deceased` boolean: A value of "true" signifies that the person is deceased, while "false" signifies that the person is alive. - `death_month` number: The month of the person's death. - `death_year` number: The year of the person's death. - `death_age` number: The age of the person at death. - `divorce` object - `divorce_month` number: The person's divorce month. - `divorce_year` number: The person's divorce year. - `marital_status` string: The person's marital status. - `marriage` object - `marriage_month` number: The person's marriage month. - `marriage_year` number: The person's marriage year. - `addresses` object[]: Addresses associated with the person. - `is_current` boolean: A value of "true" signifies that this is the person’s current address, while “false” signifies that it is not. - `state` string: The state associated with the person. - `street_address` string: The street address associated with the person. - `city` string: The city associated with the person. - `county` string: The county associated with the person. - `latitude` number: The latitude of the address associated with the person. - `longitude` number: The longitude of the address associated with the person. - `zip` string: The ZIP code associated with the person. - `is_new` boolean: Indicates if this address is newly added. - `is_new_rank_one` boolean: Indicates if this address is newly ranked as rank one. - `street_url_path` string: The URL path for the street address. - `url_path` string: The URL path for the person. - `property` object - `zoned_use` string - `use_type` string - `market_value` number - `last_sold_date` string - `living_area` number - `bath_total_count` number - `bath_partial_count` number - `bed_count` number - `area_lot` number - `year_built` number - `ownership_start_date` string - `last_sold_price` number - `sellability` object - `retail_score` number - `source_count` number - `source_date` string - `owners_count` number - `valuations` object[] - `date` string - `market_value` number - `address_delta_count` number: Number of address changes for this person. - `emails` object[]: Email addresses associated with the person. - `email` string: Email associated with the person. - `type` string: Returns whether the email is Personal or Commercial. - `domain_name` string: The organization or individual associated with the email. - `source_count` number: The number of data sources used to generate the email information. - `source_date` string: The date when the email information was sourced. - `confidence_score` number: The confidence score of the email information. - `is_new` boolean: Indicates if the email is new. - `is_new_rank_one` boolean: Indicates if the email is newly ranked as rank one. - `email_record_delta_count` number: Number of email record changes for this person. - `social_profiles` object[]: Social profiles associated with the person. - `network_name` string: The name of a social network associated with the person. - `url` string: The URL of a social profile associated with the person. - `photo_url` string: The URL of a social profile photo associated with the person. - `display_name` string: The display name of the social profile. - `last_seen_date` string: The last seen date of the social profile. - `source_count` number: The number of data sources used to generate the social profile information. - `phones` object[]: Phone numbers associated with the person. - `phone` string: Phone Number associated with the person. - `activity_status` string: Returns whether the phone line is “Active” or “Inactive”. - `line_type` string: Returns whether the phone line is “Landline”, “Wireless”, or “VOIP”. - `city` string: The city associated with the phone number's area code. - `state` string: The state associated with the phone number's area code. - `listing_type` string: Returns whether the phone service is “Residential”, “Business”, or “Special Services”. - `carrier` string: The company providing the phone service. - `source_count` number: The number of data sources used to generate the phone information. - `is_valid` boolean: A value of "true" signifies that the phone number is properly formed and assigned to a carrier. - `reputation` object - `risk_level` string: The risk level associated with the phone number. - `source_date` string: The date when the phone information was sourced. - `time_zone_name` string: The time zone name associated with the phone number. - `confidence_score` number: A score indicating the confidence level of the phone information. - `is_new` boolean: Indicates if the phone number is new. - `is_new_rank_one` boolean: Indicates if the phone number is newly ranked as rank one. - `start_date` string: The start date of the phone number association. - `end_date` string: The end date of the phone number association. - `phone_record_delta_count` number: The number of changes made to the phone record. - `relatives` object[]: Relatives associated with the person. - `id` string: A unique Spokeo identifier associated with the relative. Input this ID into Person ID Search to retrieve person data, including contact information. - `names` object[] - `full_name` string: The relative’s full name. - `first_name` string: The relative’s first name. - `middle_name` string: The relative’s middle name. - `last_name` string: The relative’s last name. - `suffix` string: The relative’s suffix. - `name_type` string: The name type of this record. - `dob_month` number: The month of the relative's date of birth. - `dob_year` number: The year of the relative's date of birth. - `is_deceased` boolean: A value of "true" signifies that the relative is deceased, while "false" signifies that the relative is alive. - `death_year` number: The year of the relative’s death. - `death_month` number: The month of the relative’s death. - `gender` string: The relative’s gender. - `marital_status` string: The relative's marital status. - `addresses` object[] - `street_address` string: The street address associated with the relative. - `city` string: The city associated with the relative. - `state` string: The state associated with the relative. - `start_year` number: The year the relative started living at this address. - `start_month` number: The month the relative started living at this address. - `end_year` number: The year the relative stopped living at this address. - `end_month` number: The month the relative stopped living at this address. - `coresidence_start_year` number: The year the relative started living with the person. - `coresidence_start_month` number: The month the relative started living with the person. - `coresidence_end_year` number: The year the relative stopped living with the person. - `coresidence_end_month` number: The month the relative stopped living with the person. - `work_history` object[]: Jobs the person held. - `is_current` boolean: A value of "true" signifies that the person is still employed in the job, while "false" signifies that the person is not. - `start_date` string: The date the person started working at the job. - `end_date` string: The date the person finished working at the job. - `company_name` string: The name of the company. - `title` string: The job title of the person. - `schools` object[]: Schools the person attended. - `name` string: The school the person attended. - `start_date` string: The date the person starting attending the school. - `type` string: The type of school the person attended. - `location` string: The location of the school the person attended - `majors` object[]: The major(s) the person studied at the school - `name` string - `certifications` object[]: Certifications the person received. - `name` string: Name of certification the person attained. - `organization` string: The name of organation the person attained certication. - `start_date` string: The date the person started the certification program. - `end_date` string: The date the person ended the certication program. - `languages` object[]: Languages the person speaks. - `language` string: The name of the language. - `proficiency` string: The proficiency level in the language. - `historical_records` object[]: Historical records of the person. - `record_type` string: The type of historical record. - `event_year` number: The year of the historical record. - `event_month` number: The month of the historical record. - `relatives` object[] - `id` string: A unique person identifier. - `relation_type` string: The type of relationship to the person. - `names` object[] - `full_name` string: The person's full name. - `first_name` string: The person's first name. - `middle_name` string: The person's middle name. - `last_name` string: The person's last name. - `maiden_name` string: The person's maiden name. - `names` object[] - `full_name` string: The person's full name. - `first_name` string: The person's first name. - `middle_name` string: The person's middle name. - `last_name` string: The person's last name. - `maiden_name` string: The person's maiden name. - `birth` object - `dob_month` number: The month of birth. - `dob_year` number: The year of birth. - `dob_zodiac` string: The zodiac sign of the person. - `death` object - `is_deceased` boolean: Indicates if the person is deceased. - `address` object - `city` string: The city of the person's address. - `location` string: The location of the person's address. - `state` string: The state of the person's address. - `metadata` object ## Other responses - `400`: Bad Request --- [API](https://skmtc.dev/spokeo/apis/spokeo-5-api.md) - [All operations](https://skmtc.dev/spokeo/apis/spokeo-5-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spokeo/apis/spokeo-5-api/revisions/ae5285edf19c?raw)