Person Search

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 and legal indicators the api supports investigative, kyc, fraud detection, and customer intelligence applications 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 person search can be used in a variety of ways if you are searching for a specific individual user can use combinations such as ssn first name + last name first name + last name + address first name + last name +dob user can also search on specific attributes to see individuals shown associated with that attributes phone email address minimum input requirement (any one of the following) firstname + lastname ssn phone email addresses (addressline1 + addressline2 with state and zip code) driverlicensenumber + driverlicensestate api input production curl location 'https //api signzy us/api/v3/us/person search' \\ \ 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' \\ \ 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 true 152,152,152,153 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type api output { "result" { "persons" \[ { "id" "g5789359913988571971", "name" { "prefix" "", "firstname" "john", "middlename" "a", "lastname" "doe", "suffix" "", "rawnames" \[ "john a" ], "publicfirstseendate" "2020 07 12", "totalfirstseendate" "2016 06 12", "sourcesummary" "" }, "ssn" "123 12 xxxx", "socialsecuritynumbers" \[ { "ssn" "123 12 xxxx", "sourcesummary" "" } ], "ssnfirstseen" "2016 07 08", "ssnlastseen" "2024 29 12", "dob" "1990 02 xx", "age" 35, "datesofbirth" \[ { "dob" "1990 02 xx", "age" 35, "sourcesummary" "" }, { "dob" "", "age" 35, "sourcesummary" "" }, { "dob" "2000 01 xx", "age" 25, "sourcesummary" "" } ], "dobfirstseen" "2016 07 08", "doblastseen" "2024 12 29", "datesofdeath" \[], "akas" \[ { "prefix" "", "firstname" "john", "middlename" "", "lastname" "doe", "suffix" "", "rawnames" \[ "john doe" ], "publicfirstseendate" "2020 11 03", "totalfirstseendate" "2016 12 06", "sourcesummary" "" }, { "prefix" "", "firstname" "john", "middlename" "", "lastname" "doe", "suffix" "", "rawnames" \[ "doe, john", "john doe" ], "publicfirstseendate" "2022 09 29", "totalfirstseendate" "2022 09 29", "sourcesummary" "" }, { "prefix" "", "firstname" "john", "middlename" "arnold", "lastname" "doe", "suffix" "", "rawnames" \[ "doe, john arnold", "john arnold doe" ], "publicfirstseendate" "2023 04 18", "totalfirstseendate" "2023 04 18", "sourcesummary" "" } ], "locations" \[ { "city" "aurora", "state" "il" }, { "city" "naperville", "state" "il" }, { "city" "northbrook", "state" "il" }, { "city" "chicago", "state" "il" }, { "city" "hudson falls", "state" "ny" }, { "city" "plymouth", "state" "ma" } ], "addresses" \[ { "addresshash" "5342744394334380123", "housenumber" "1234", "streetpredirection" "s", "streetname" "michigan ave", "streetpostdirection" "", "streettype" "ave", "unit" "", "unittype" "", "city" "chicago", "state" "il", "county" "cook", "zip" "60411", "zip4" "3702", "dpc" "96", "latitude" "41 878175", "longitude" " 87 629825", "addressorder" 1, "highriskmarker" { "ishighrisk" false, "sic" "", "addresstype" "" }, "firstreporteddate" "2020 01 01", "lastreporteddate" "2025 07 01", "publicfirstseendate" "2021 12 08", "totalfirstseendate" "2021 12 08", "fulladdress" "1234, s michigan ave, chicago, il 60411 3702", "sourcesummary" "" }, { "addresshash" " 4155233217638734947", "housenumber" "1234", "streetpredirection" "", "streetname" "station", "streetpostdirection" "", "streettype" "blvd", "unit" "123", "unittype" "unit", "city" "aurora", "state" "il", "county" "dupage", "zip" "60504", "zip4" "2136", "dpc" "14", "latitude" "41 768615", "longitude" " 88 213799", "addressorder" 2, "highriskmarker" { "ishighrisk" false, "sic" "", "addresstype" "" }, "firstreporteddate" "2020 01 01", "lastreporteddate" "2023 02 06", "publicfirstseendate" "2021 03 25", "totalfirstseendate" "2021 02 26", "fulladdress" "1234 station blvd, unit 123; aurora, il 60504 2136", "sourcesummary" "" }, { "addresshash" " 8602062154728889716", "housenumber" "1234", "streetpredirection" "", "streetname" "bromley", "streetpostdirection" "", "streettype" "ln", "unit" "", "unittype" "", "city" "aurora", "state" "il", "county" "dupage", "zip" "60502", "zip4" "6520", "dpc" "77", "latitude" "41 778572", "longitude" " 88 236893", "addressorder" 3, "highriskmarker" { "ishighrisk" false, "sic" "", "addresstype" "" }, "firstreporteddate" "2020 08 11", "lastreporteddate" "2020 08 11", "publicfirstseendate" "2020 03 11", "totalfirstseendate" "2020 09 24", "fulladdress" "1234 bromley ln; aurora, il 60502 6520", "sourcesummary" "" } ], "phonenumbers" \[ { "phonenumber" "(123) 123 1234", "company" "t mobile usa inc", "location" "chicago, il", "phonetype" "wireless", "isconnected" true, "latitude" "42 17201", "longitude" " 87 84785", "phoneorder" 1, "firstreporteddate" "2019 08 01", "lastreporteddate" "2025 07 01", "publicfirstseendate" "2020 10 28", "totalfirstseendate" "2019 09 15", "sourcesummary" "" } ], "emailaddresses" \[ { "emailaddress" "john d\@example com", "emailordinal" 1, "nonbusiness" 1, "sourcesummary" "" } ], "fullname" "john a doe", "indicators" { "hasbankruptcyrecords" 0, "hasbusinessrecords" 0, "hasdivorcerecords" 0, "hasdomainsrecords" 0, "hasevictionsrecords" 0, "hasfeinrecords" 0, "hasforeclosuresrecords" 0, "hasforeclosuresv2records" 0, "hasjudgmentrecords" 0, "haslienrecords" 0, "hasmarriagerecords" 0, "hasprofessionallicenserecords" 2, "haspropertyrecords" 0, "hasvehicleregistrationsrecords" 0, "hasworkplacerecords" 0, "hasdearecords" 0, "haspropertyv2records" 3, "hasuccrecords" 0, "hasunbankeddata" 2, "hasmobilephones" 5, "haslandlines" 6, "hasemails" 7, "hasaddresses" 16, "hascurrentaddresses" 1, "hashistoricaladdresses" 15, "hasdebtrecords" 0 }, "driverslicensedetail" \[], "hasadditionaldata" false, "propensitytopayscore" { "transactionid" "", "suffix" "", "firstname" "", "middlename" "", "lastname" "", "address" "", "city" "", "state" "", "zip" "", "zip4" "", "measures" \[] } } ], "counts" { "businessrecords" 0, "debtrecords" 0, "evictionrecords" 0, "foreclosurerecords" 0, "foreclosurev2records" 0, "professionallicenserecords" 0, "expectedcount" 1 }, "resultscount" 10, "searchcriteria" \[], "requestid" "2b4af231 efcd 4a45 ba5f a1234567be0e", "requesttype" "personsearch", "iserror" false, "error" { "inputerrors" \[], "warnings" \[] } }, "reason" "request successful", "code" "s001" } api output schema true 152,152,152,153 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type success codes true 203,203,203 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type error codes true 148,100left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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!