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 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 { "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 field description datatype required? example value persons array of person objects containing detailed information about individuals array of objects yes see below persons id unique identifier for the person (tahoeid) string yes g5789359913988571971 persons name object containing name details of the person object yes see below persons name prefix prefix of the person's name string no dr persons name firstname first name of the person string yes saurin persons name middlename middle name of the person string no n persons name lastname last name of the person string yes parikh persons name suffix suffix of the person's name string no persons name rawnames array of raw name strings as they appear in source data array of strings no \["saurin n parikh"] persons name publicfirstseendate date when the name was first seen in public records string (yyyy mm dd) yes 2020 07 16 persons name totalfirstseendate date when the name was first seen in any records string no 2016 12 06 persons name sourcesummary summary of the source data for the name string no null persons ssn social security number (partially masked) string yes 796 61 xxxx persons socialsecuritynumbers array of ssn objects array of objects yes see below persons socialsecuritynumbers ssn social security number (partially masked) string yes 796 61 xxxx persons socialsecuritynumbers sourcesummary summary of the source data for the ssn string no null persons ssnfirstseen date when the ssn was first seen string no 7/8/2016 persons ssnlastseen date when the ssn was last seen string no 12/29/2024 persons dob date of birth (partially masked) string yes 2/xx/1990 persons age age of the person integer yes 35 persons datesofbirth array of date of birth objects array of objects yes see below persons datesofbirth dob date of birth (partially masked) string yes 2/xx/1990 persons datesofbirth age age associated with the date of birth integer no 35 persons datesofbirth sourcesummary summary of the source data for the date of birth string no null persons dobfirstseen date when the dob was first seen string yes 7/8/2016 persons doblastseen date when the dob was last seen string yes 12/29/2024 persons datesofdeath array of objects array yes \[] persons datesofdeath deathrecords object object no see below persons datesofdeath deathrecords isdeceased identifier if person is deceased boolean no true/ false persons akas array of alias objects (also known as names) array of objects yes see below persons akas prefix prefix of the alias name string no persons akas firstname first name of the alias string yes saurin persons akas middlename middle name of the alias string no naimesh persons akas lastname last name of the alias string yes parikh persons akas suffix suffix of the alias name string no persons akas rawnames array of raw alias name strings array of strings yes \["parikh, saurin naimesh", "saurin naimesh parikh"] persons akas publicfirstseendate date when the alias was first seen in public records string no 4/18/2023 persons akas totalfirstseendate date when the alias was first seen in any records string no 4/18/2023 persons akas sourcesummary summary of the source data for the alias string no null persons locations array of location objects (city and state) array of objects yes see below persons locations city city of the location string yes aurora persons locations state state of the location string yes il persons addresses array of address objects array of objects yes see below persons addresses addresshash unique hash for the address string yes 5342744394334380373 persons addresses housenumber house number of the address string yes 2796 persons addresses streetpredirection pre directional indicator of the street string no persons addresses streetname name of the street string yes nicole persons addresses streetpostdirection post directional indicator of the street string no persons addresses streettype type of street (e g , cir, blvd) string yes cir persons addresses unit unit or apartment number string no 414 persons addresses unittype type of unit (e g , apt, unit) string no unit persons addresses city city of the address string yes aurora persons addresses state state of the address string yes il persons addresses county county of the address string yes kane persons addresses zip zip code of the address string yes 60502 persons addresses zip4 four digit zip code extension string no 3702 persons addresses dpc delivery point code string no 96 persons addresses latitude latitude of the address string no 41 811075 persons addresses longitude longitude of the address string no 88 267025 persons addresses addressorder order of the address in the list integer yes 1 persons addresses highriskmarker object indicating if the address is high risk object yes see below persons addresses highriskmarker ishighrisk indicates if the address is high risk boolean yes false persons addresses highriskmarker sic standard industrial classification code string yes persons addresses highriskmarker addresstype type of address string yes persons addresses firstreporteddate date when the address was first reported string no 1/1/2020 persons addresses lastreporteddate date when the address was last reported string no 6/1/2025 persons addresses publicfirstseendate date when the address was first seen in public records string no 12/8/2021 persons addresses totalfirstseendate date when the address was first seen in any records string no 12/8/2021 persons addresses fulladdress full formatted address string string yes 2796 nicole cir; aurora, il 60502 3702 persons addresses sourcesummary summary of the source data for the address string no null persons phonenumbers array of phone number objects array of objects yes see below persons phonenumbers phonenumber phone number string yes (224) 507 4373 persons phonenumbers company phone service provider string yes t mobile usa inc persons phonenumbers location location associated with the phone number string yes chicago, il persons phonenumbers phonetype type of phone (e g , wireless) string no wireless persons phonenumbers isconnected indicates if the phone number is connected boolean yes true persons phonenumbers latitude latitude associated with the phone number string no 42 17201 persons phonenumbers longitude longitude associated with the phone number string no 87 84785 persons phonenumbers phoneorder order of the phone number in the list integer yes 1 persons phonenumbers firstreporteddate date when the phone number was first reported string no 7/1/2019 persons phonenumbers lastreporteddate date when the phone number was last reported string no 6/1/2025 persons phonenumbers publicfirstseendate date when the phone number was first seen in public records string no 10/28/2020 persons phonenumbers totalfirstseendate date when the phone number was first seen in any records string no 9/15/2019 persons phonenumbers sourcesummary summary of the source data for the phone number string no null persons emailaddresses array of email address objects array of objects yes see below persons emailaddresses emailaddress email address string yes saurin212\@gmail com persons emailaddresses emailordinal order of the email address in the list integer yes 1 persons emailaddresses nonbusiness indicates if the email is non business integer no 1 persons emailaddresses sourcesummary summary of the source data for the email address string no null persons fullname full name of the person string yes saurin n parikh persons indicators hasbankruptcyrecords indicates whether bankruptcy records exist (count of records found) integer yes 0 persons indicators hasbusinessrecords indicates whether business related records exist integer yes 0 persons indicators hasdivorcerecords indicates whether divorce records exist integer yes 0 persons indicators hasdomainsrecords indicates whether domain registration records exist integer yes 0 persons indicators hasevictionsrecords indicates whether eviction records exist integer yes 0 persons indicators hasfeinrecords indicates whether federal employer identification number (fein) records exist integer yes 0 persons indicators hasforeclosuresrecords indicates whether foreclosure records exist integer yes 0 persons indicators hasforeclosuresv2records indicates whether updated/secondary foreclosure records exist integer yes 0 persons indicators hasjudgmentrecords indicates whether judgment records exist integer yes 0 persons indicators haslienrecords indicates whether lien records exist integer yes 0 persons indicators hasmarriagerecords indicates whether marriage records exist integer yes 0 persons indicators hasprofessionallicenserecords indicates the number of professional license records integer yes 2 persons indicators haspropertyrecords indicates whether property ownership records exist integer yes 0 persons indicators hasvehicleregistrationsrecords indicates whether vehicle registration records exist integer yes 0 persons indicators hasworkplacerecords indicates whether workplace related records exist integer yes 0 persons indicators hasdearecords indicates whether dea (drug enforcement administration) license records exist integer yes 0 persons indicators haspropertyv2records indicates updated/secondary property ownership records integer yes 3 persons indicators hasuccrecords indicates whether ucc (uniform commercial code) filing records exist integer yes 0 persons indicators hasunbankeddata indicates whether unbanked/alternative financial data exists integer yes 2 persons indicators hasmobilephones number of mobile phone records found integer yes 5 persons indicators haslandlines number of landline phone records found integer yes 6 persons indicators hasemails number of email address records found integer yes 7 persons indicators hasaddresses number of all addresses (current and historical) found integer yes 16 persons indicators hascurrentaddresses number of current addresses found integer yes 1 persons indicators hashistoricaladdresses number of historical addresses found integer yes 15 persons indicators hasdebtrecords indicates whether debt related records exist integer yes 0 persons driverslicensedetail array of driver’s license details array yes \[] persons hasadditionaldata indicates if additional data is available boolean yes false persons propensitytopayscore object containing propensity to pay score details object yes see below persons propensitytopayscore transactionid transaction id for the score string no persons propensitytopayscore suffix suffix for the score string no persons propensitytopayscore firstname first name for the score string no persons propensitytopayscore middlename middle name for the score string no persons propensitytopayscore lastname last name for the score string no persons propensitytopayscore address address for the score string no persons propensitytopayscore city city for the score string no persons propensitytopayscore state state for the score string no persons propensitytopayscore zip zip code for the score string no persons propensitytopayscore zip4 four digit zip code extension for the score string no persons propensitytopayscore measures array of measures for the score array yes \[] counts object containing counts of various record types object yes see below counts businessrecords number of business records integer yes 0 counts debtrecords number of debt records integer yes 0 counts evictionrecords number of eviction records integer yes 0 counts foreclosurerecords number of foreclosure records integer yes 0 counts foreclosurev2records number of foreclosure v2 records integer yes 0 counts professionallicenserecords number of professional license records integer yes 0 resultscount number of results returned integer yes 10 searchcriteria array of search criteria used array no \[] requestid unique identifier for the request string yes c94ef1ca 65f5 4515 a926 0c0710d1dd79 requesttype type of request string yes personsearch iserror indicates if the request resulted in an error boolean yes false error object containing error details object yes see below error inputerrors array of input errors array yes \[] error warnings array of warning messages array of strings yes \["search included phone number overriding idranking with phonesearchranking "] 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 help\@signzy com 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!