Person Search - Advanced

overview the api enables users to retrieve detailed identity and background information for individuals using flexible combinations of attributes such as name, date of birth, ssn, phone number, email, and address it integrates to deliver comprehensive person level data including demographics, contact details, address history, phone number history, legal indicators, associates, neighbours, relatives and household composition usecases kyc & regulatory compliance verify customer identity (e g , name, dob, ssn) during onboarding fraud prevention cross check provided contact and address details with authoritative public records identity risk analysis detects inconsistencies in provided vs retrieved data residency & contact history validate location and communication history to assess stability api details api input production curl location 'https //api signzy us/api/v3/us/person search advance' \\ \ header 'authorization \<auth token>' \\ \ header 'content type application/json' \\ \ data raw '{ "firstname" "john", "middlename" "a", "lastname" "doe", "ssn" "123456789", "dob" "02/21/1990", "age" 36, "agerangeminage" 10, "agerangemaxage" 50, "email" "john d\@example com", "phone" "1231231234", "addresses" \[ { "addressline1" "1234, s michigan ave, chicago", "addressline2" "il 60605" } ], "driverlicensenumber" "p12312341234", "driverlicensestate" "il", "akas" \[ { "names" "john,john a,doe" } ], "maxaddressyears" 20, "maxphoneyears" 20, "resultscount" 10 }' pre production curl location 'https //api preproduction signzy us/api/v3/us/person search advance' \\ \ header 'authorization \<auth token>' \\ \ header 'content type application/json' \\ \ data raw '{ "firstname" "john", "middlename" "a", "lastname" "doe", "ssn" "123456789", "dob" "1990 02 30", "age" 36, "agerangeminage" 10, "agerangemaxage" 50, "email" "john d\@example com", "phone" "1231231234", "addresses" \[ { "addressline1" "1234, s michigan ave, chicago", "addressline2" "il 60605" } ], "driverlicensenumber" "p12312341234", "driverlicensestate" "il", "akas" \[ { "names" "john,john a,doe" } ], "maxaddressyears" 20, "maxphoneyears" 20, "resultscount" 10 }' note while fields are marked optional, the minimum input requirement mentioned above must be satisfied for a search api input schema parameter required data type description firstname optional string first name of the person being searched middlename optional string middle name of person lastname optional string last name or surname of the person being searched ssn optional string social security number (format #########) dob optional string ("yyyy mm dd") date of birth (format yyyy mm dd) age optional int age of the person agerangeminage optional int minimum age for range based searches agerangemaxage optional int maximum age for range based searches email optional string email address associated with the person phone optional string phone number associated with the person addresses\[] addressline1 optional string address line 1 associated with the person (street number) addresses\[] addressline2 optional string address line 2 associated with the person (city, state, zip code) driverlicensenumber optional string driver's license number associated with the person being searched driverlicensestate optional string issuing state of the driver’s license akas\[] names optional string list of aliases or alternative names of the person maxaddressyears optional int exclude addresses older than this number of years max value 500 maxphoneyears optional int exclude phone numbers older than this number of years max value 500 resultscount optional int max number of results users wants to see in response default value 10 maximum of 50 results in a request value of resultscount can be less than the input in response api output { "statuscode" 200, "code" "s001", "message" "", "result" { "persons" \[ { "id" "tah 78234910", "name" { "prefix" "", "firstname" "james", "middlename" "robert", "lastname" "mitchell", "suffix" "", "rawnames" \[ { "firstname" "james", "middlename" "robert", "lastname" "mitchell" } ], "publicfirstseendate" "2005 03 15", "totalfirstseendate" "2001 07 22", "sources" { "name" "credit bureau", "reporteddate" "2023 11 01" } }, "fullname" "james robert mitchell", "dob" "1982 08 14", "age" "41", "datesofbirth" \[ { "dob" "1982 08 14", "age" "41" } ], "dobfirstseen" "2003 01 10", "doblastseen" "2023 09 05", "datesofdeath" \[], "hasadditionaldata" "true", "iscurrentpropertyowner" "true", "deathrecords" { "isdeceased" "false" }, "akas" \[ { "prefix" "", "firstname" "jim", "middlename" "r", "lastname" "mitchell", "suffix" "", "rawnames" \[ { "firstname" "jim", "middlename" "r", "lastname" "mitchell" } ], "publicfirstseendate" "2010 06 01", "totalfirstseendate" "2008 04 15", "sources" { "name" "voter registration", "reporteddate" "2022 05 10" } } ], "locations" \[ { "city" "austin", "state" "tx" } ], "addresses" \[ { "addresshash" "addr 001 hash", "housenumber" "4821", "streetpredirection" "", "streetname" "maple", "streetpostdirection" "", "streettype" "ave", "unit" "", "unittype" "", "city" "austin", "state" "tx", "county" "travis", "zip" "78745", "zip4" "3301", "dpc" "", "latitude" "30 2240", "longitude" " 97 7793", "addressorder" "1", "fulladdress" "4821 maple ave, austin, tx 78745", "firstreporteddate" "2018 06 01", "lastreporteddate" "2024 02 15", "publicfirstseendate" "2018 06 01", "totalfirstseendate" "2018 06 01", "highriskmarker" { "ishighrisk" "false", "sic" "", "addresstype" "residential" }, "sources" { "name" "utility records", "reporteddate" "2024 02 15" }, "propertyindicator" "1", "bldgcode" "sf", "utilitycode" "e", "unitcount" "1", "phonenumbers" \[ { "phonenumber" "5124789023", "phonetype" "landline" } ] }, { "addresshash" "addr 002 hash", "housenumber" "302", "streetpredirection" "n", "streetname" "congress", "streetpostdirection" "", "streettype" "st", "unit" "5b", "unittype" "apt", "city" "austin", "state" "tx", "county" "travis", "zip" "78701", "zip4" "1122", "dpc" "", "latitude" "30 2672", "longitude" " 97 7431", "addressorder" "2", "fulladdress" "302 n congress st apt 5b, austin, tx 78701", "firstreporteddate" "2012 03 10", "lastreporteddate" "2017 11 30", "publicfirstseendate" "2012 03 10", "totalfirstseendate" "2012 03 10", "highriskmarker" { "ishighrisk" "false", "sic" "", "addresstype" "residential" }, "sources" { "name" "postal records", "reporteddate" "2017 11 30" } } ], "phonenumbers" \[ { "phonenumber" "5129871234", "company" "at\&t", "location" "austin, tx", "phonetype" "mobile", "isconnected" "true", "latitude" "30 2672", "longitude" " 97 7431", "phoneorder" "1", "firstreporteddate" "2015 04 22", "lastreporteddate" "2024 01 10", "publicfirstseendate" "2015 04 22", "totalfirstseendate" "2015 04 22", "sources" { "name" "carrier records", "reporteddate" "2024 01 10" } }, { "phonenumber" "5124789023", "company" "spectrum", "location" "austin, tx", "phonetype" "landline", "isconnected" "false", "latitude" "", "longitude" "", "phoneorder" "2", "firstreporteddate" "2018 06 01", "lastreporteddate" "2022 08 15", "publicfirstseendate" "2018 06 01", "totalfirstseendate" "2018 06 01", "sources" { "name" "utility records", "reporteddate" "2022 08 15" } } ], "emailaddresses" \[ { "emailaddress" "j mitchell\@email com", "emailordinal" "1", "nonbusiness" "1", "sources" { "name" "e commerce", "reporteddate" "2020 09 12" } } ], "driverslicensedetail" \[], "propensitytopayscore" { "transactionid" "", "suffix" "", "firstname" "", "middlename" "", "lastname" "", "address" "", "city" "", "state" "", "zip" "", "zip4" "", "measures" \[] }, "householdcomposition" \[ { "id" "tah 88234001", "isspouse" "true", "isdeceased" "false", "fullname" "sarah lynn mitchell", "name" { "prefix" "", "firstname" "sarah", "middlename" "lynn", "lastname" "mitchell", "suffix" "", "rawnames" \[ { "firstname" "sarah", "middlename" "lynn", "lastname" "mitchell" } ], "publicfirstseendate" "2010 09 01", "totalfirstseendate" "2010 09 01", "sources" { "name" "voter registration", "reporteddate" "2023 10 01" } }, "age" "39", "dob" "1984 04 22", "ssn" "xxx xx 5678", "dod" "", "akas" \[], "currentaddress" { "addresshash" "addr 001 hash", "housenumber" "4821", "streetpredirection" "", "streetname" "maple", "streetpostdirection" "", "streettype" "ave", "unit" "", "unittype" "", "city" "austin", "state" "tx", "county" "travis", "zip" "78745", "zip4" "3301", "dpc" "", "addressorder" "1", "latitude" "30 2240", "longitude" " 97 7793", "fulladdress" "4821 maple ave, austin, tx 78745", "firstreporteddate" "2018 06 01", "lastreporteddate" "2024 02 15", "publicfirstseendate" "2018 06 01", "totalfirstseendate" "2018 06 01", "highriskmarker" { "ishighrisk" "false", "sic" "", "addresstype" "residential" }, "sources" { "name" "utility records", "reporteddate" "2024 02 15" }, "propertyindicator" "1" }, "phone1" "5129871235", "phone1type" "mobile", "phone1firstreported" "2016 03 10", "phone1lastreported" "2024 01 05", "email1" "sarah mitchell\@email com", "iscurrentpropertyowner" "true", "sources" { "name" "credit bureau", "reporteddate" "2023 11 01" } } ], "relativessummary" \[ { "id" "tah 77100234", "prefix" "", "firstname" "david", "middlename" "", "lastname" "mitchell", "suffix" "", "dob" "1955 12 03", "isprivate" "false", "isdeceased" "false", "relativelevel" "1", "relativetype" "father", "spouse" "false", "sharedhouseholdids" \[], "score" "98", "oldspouse" "false", "city" "san antonio", "state" "tx", "sources" { "name" "family records", "reporteddate" "2022 06 15" } }, { "id" "tah 77100235", "prefix" "", "firstname" "carol", "middlename" "ann", "lastname" "mitchell", "suffix" "", "dob" "1958 07 19", "isprivate" "false", "isdeceased" "false", "relativelevel" "1", "relativetype" "mother", "spouse" "false", "sharedhouseholdids" \[], "score" "97", "oldspouse" "false", "city" "san antonio", "state" "tx", "sources" { "name" "family records", "reporteddate" "2022 06 15" } } ], "associatessummary" \[ { "id" "tah 66100401", "prefix" "", "firstname" "michael", "middlename" "t", "lastname" "harris", "suffix" "", "dob" "1980 11 30", "isprivate" "false", "isdeceased" "false", "score" "82", "sources" { "name" "business records", "reporteddate" "2021 04 20" } } ], "associates" \[ { "id" "tah 66100401", "name" { "prefix" "", "firstname" "michael", "middlename" "t", "lastname" "harris", "suffix" "", "rawnames" \[ { "firstname" "michael", "middlename" "t", "lastname" "harris" } ], "publicfirstseendate" "2008 02 14", "totalfirstseendate" "2006 09 01", "sources" { "name" "business records", "reporteddate" "2021 04 20" } }, "fullname" "michael t harris", "dob" "1980 11 30", "age" "43", "datesofbirth" \[ { "dob" "1980 11 30", "age" "43" } ], "dobfirstseen" "2005 01 01", "doblastseen" "2023 07 01", "datesofdeath" \[], "akas" \[], "locations" \[ { "city" "austin", "state" "tx" } ], "addresses" \[ { "addresshash" "addr asc 001", "housenumber" "900", "streetpredirection" "", "streetname" "lamar", "streetpostdirection" "", "streettype" "blvd", "unit" "", "unittype" "", "city" "austin", "state" "tx", "county" "travis", "zip" "78703", "zip4" "", "dpc" "", "latitude" "30 2700", "longitude" " 97 7580", "addressorder" "1", "fulladdress" "900 lamar blvd, austin, tx 78703", "firstreporteddate" "2016 05 01", "lastreporteddate" "2024 01 01", "publicfirstseendate" "2016 05 01", "totalfirstseendate" "2016 05 01", "highriskmarker" { "ishighrisk" "false", "sic" "", "addresstype" "residential" }, "sources" { "name" "business records", "reporteddate" "2021 04 20" } } ], "phonenumbers" \[ { "phonenumber" "5124561890", "company" "t mobile", "location" "austin, tx", "phonetype" "mobile", "isconnected" "true", "latitude" "", "longitude" "", "phoneorder" "1", "firstreporteddate" "2017 03 01", "lastreporteddate" "2024 01 01", "publicfirstseendate" "2017 03 01", "totalfirstseendate" "2017 03 01", "sources" { "name" "carrier records", "reporteddate" "2024 01 01" } } ], "emailaddresses" \[], "driverslicensedetail" \[], "hasadditionaldata" "true", "propensitytopayscore" { "transactionid" "", "suffix" "", "firstname" "", "middlename" "", "lastname" "", "address" "", "city" "", "state" "", "zip" "", "zip4" "", "measures" \[] }, "deathrecords" { "isdeceased" "false" } } ], "neighborssummary" \[ { "id" "tah 55200111", "firstname" "linda", "middlename" "", "lastname" "torres", "dob" "1977 03 05", "city" "austin", "state" "tx", "zip" "78745", "age" "47", "email" "l torres\@email com", "sources" { "name" "postal records", "reporteddate" "2023 12 01" } } ], "neighbors" \[ { "id" "tah 55200111", "name" { "prefix" "", "firstname" "linda", "middlename" "", "lastname" "torres", "suffix" "", "rawnames" \[ { "firstname" "linda", "lastname" "torres" } ], "publicfirstseendate" "2015 01 01", "totalfirstseendate" "2015 01 01", "sources" { "name" "postal records", "reporteddate" "2023 12 01" } }, "fullname" "linda torres", "dob" "1977 03 05", "age" "47", "datesofbirth" \[ { "dob" "1977 03 05", "age" "47" } ], "dobfirstseen" "", "doblastseen" "", "datesofdeath" \[], "akas" \[], "locations" \[ { "city" "austin", "state" "tx" } ], "addresses" \[ { "addresshash" "addr nbr 001", "housenumber" "4819", "streetpredirection" "", "streetname" "maple", "streetpostdirection" "", "streettype" "ave", "unit" "", "unittype" "", "city" "austin", "state" "tx", "county" "travis", "zip" "78745", "zip4" "", "dpc" "", "latitude" "30 2239", "longitude" " 97 7792", "addressorder" "1", "fulladdress" "4819 maple ave, austin, tx 78745", "firstreporteddate" "2015 01 01", "lastreporteddate" "2023 12 01", "publicfirstseendate" "2015 01 01", "totalfirstseendate" "2015 01 01", "highriskmarker" { "ishighrisk" "false", "sic" "", "addresstype" "residential" }, "sources" { "name" "postal records", "reporteddate" "2023 12 01" } } ], "phonenumbers" \[ { "phonenumber" "5127654321", "company" "verizon", "location" "austin, tx", "phonetype" "mobile", "isconnected" "true", "latitude" "", "longitude" "", "phoneorder" "1", "firstreporteddate" "2016 08 01", "lastreporteddate" "2023 12 01", "publicfirstseendate" "2016 08 01", "totalfirstseendate" "2016 08 01", "sources" { "name" "carrier records", "reporteddate" "2023 12 01" } } ], "emailaddresses" \[ { "emailaddress" "l torres\@email com", "emailordinal" "1", "nonbusiness" "1", "sources" { "name" "e commerce", "reporteddate" "2021 06 10" } } ], "driverslicensedetail" \[], "hasadditionaldata" "false", "propensitytopayscore" { "transactionid" "", "suffix" "", "firstname" "", "middlename" "", "lastname" "", "address" "", "city" "", "state" "", "zip" "", "zip4" "", "measures" \[] } } ] } ], "counts" { "businessrecords" "3", "debtrecords" "1", "evictionrecords" "0", "foreclosurerecords" "0", "foreclosurev2records" "0", "professionallicenserecords" "2", "expectedcount" "1" }, "resultscount" "1", "searchcriteria" \[ { "field" "firstname", "value" "james" }, { "field" "lastname", "value" "mitchell" } ], "requestid" "req 20260330 001", "requesttype" "personsearch" } } api output schema root level field description data type statuscode http status code number code internal response code string message response message string result main response payload object result object field description data type result persons\[] list of matched persons array result counts summary counts of records object result resultscount number of results returned string result searchcriteria\[] input search parameters array result requestid unique request id string result requesttype type of request string person object (result persons\[]) field description data type id unique person id string fullname full name of person string name structured name object object dob primary date of birth date age age of person string datesofbirth\[] all dob records array dobfirstseen first seen dob date date doblastseen last seen dob date date datesofdeath\[] death records array hasadditionaldata additional data flag boolean (string) iscurrentpropertyowner property ownership flag boolean (string) deathrecords death info object akas\[] alternate names array locations\[] known locations array addresses\[] address records array phonenumbers\[] phone records array emailaddresses\[] email records array driverslicensedetail\[] dl info array propensitytopayscore payment score info object householdcomposition\[] household members array relativessummary\[] relatives summary array associatessummary\[] associates summary array associates\[] detailed associates array neighborssummary\[] neighbors summary array neighbors\[] detailed neighbors array name object field description data type prefix title string firstname first name string middlename middle name string lastname last name string suffix suffix string rawnames\[] raw name variations array publicfirstseendate public first seen date date totalfirstseendate total first seen date date sources source info object dates of birth object field description data type dob date of birth date age age string address object field description data type addresshash unique address id string fulladdress full formatted address string housenumber house number string streetname street name string streettype street type string unit unit number string unittype unit type string city city string state state string county county string zip zip code string zip4 extended zip string latitude latitude string longitude longitude string firstreporteddate first reported date date lastreporteddate last reported date date addressorder ranking/order string highriskmarker risk info object sources source info object phonenumbers\[] phones linked to address array phone object field description data type phonenumber phone number string company carrier name string location phone location string phonetype type (mobile/landline) string isconnected active status boolean (string) firstreporteddate first seen date lastreporteddate last seen date sources source info object email object field description data type emailaddress email id string emailordinal ranking string nonbusiness personal/business flag string sources source info object household object field description data type id household member id string fullname name string isspouse spouse flag boolean (string) dob date of birth date age age string currentaddress address object object phone1 primary phone string email1 email string counts object field description data type businessrecords count of business records string debtrecords count of debt records string evictionrecords count of evictions string foreclosurerecords count of foreclosures string professionallicenserecords license records string expectedcount expected results string search criteria object field description data type field search field name string value search value string success codes http status code success code description 200 s001 request successful 200 s003 request successful but no person found with the provided data error codes http status code description 400 bad request invalid input data 401 invalid authentication token 409 upstream error getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!