SSN Trace

introduction due diligence is one of the first checks that is done for background verification of any gig worker, blue collar worker, and several other working classes the sources for such checks can be very diverse and include federal and state criminal databases, motor vehicle report checks, civil court checks, etc signzy has created a global ndd product that has an exhaustive list of sources through which an employer, or any entity can be sure that the person they are going to work with is a trustworthy individual as a first step, we have already national criminal checks, pep, adverse media & watchlists checks api required for background verification of the person now, the ssn trace api is used to verify the user's identity and and details associated with the user social security trace searches are performed with every background check to indicate the name and address history of an applicant ssn trace will also confirm whether the social security number is valid and matches the candidate’s name and address history ssn trace will give insight to which jurisdictions should be searched please note that this is not an alternative of ssn verification service the search is typically the first step and often combined with a natcrim search to confirm or to indicate potential criminal record history this information is used as an indicator of potential risk a candidate could pose to an organization by searching an ssn, we will provide the name(s), address(es), and phone number(s) associated with that identification number from a variety of sources api applications some important business areas where the ssn trace api is very helpful are fraud detection the api can help detect potential fraud by comparing the provided ssn against databases to identify inconsistencies or discrepancies background checks employers and organizations can use ssn traces for background checks during the hiring process to validate a candidate's identity and history compliance in regulated industries such as finance and healthcare, using ssn traces can help comply with legal and regulatory requirements for customer due diligence and know your customer (kyc) procedures customer onboarding businesses can streamline customer onboarding processes by using ssn traces to quickly verify identity information provided by customers reduced errors manual data entry errors can occur when collecting personal information an ssn trace api can minimize errors by automating the retrieval of accurate details associated with an ssn enhanced data accuracy the api can provide up to date and accurate information about individuals, improving the quality of data in customer databases risk assessment financial institutions and lending companies can use ssn traces as part of their risk assessment processes to determine an applicant's creditworthiness personalization for marketing and customer service purposes, having accurate customer information can enable personalized interactions and communications efficiency instead of manually verifying ssn information, the api allows for quick and automated data retrieval note the ssn (social security number) trace is intended to verify the personal identifying information associated with a specific individual's social security number an ssn trace supplies details about names and addresses associated with a specific social security number and can offer insights into address history however, it’s important to note that ssn traces do not confirm the authenticity of the ssn or validate that it belongs to the individual providing it the accuracy of the information in the trace depends on the reliability of the reporting agencies api details you must first login before sending the request the authorization header in the request must include the access token obtained from the login api call need to pass the following information providing ssn is mandatory rest other fields can be used by client to filter out the data more accurately ssn firstname lastname maxaddressyears sample curl curl location 'https //api signzy us/api/v3/us kyc/ssn trace' \\ \ header 'content type application/json' \\ \ header 'authorization \<token>' \\ \ data '{ "ssn" "123456789", "firstname" "john", "lastname" "doe", "maxaddressyears" "5" }'curl location 'https //api preproduction signzy us/api/v3/us kyc/ssn trace' \\ \ header 'content type application/json' \\ \ header 'authorization \<token>' \\ \ data '{ "ssn" "", "firstname" "", "lastname" "", "maxaddressyears" "" }' request body parameters parameter data type required description ssn string yes social security number accepts 9 digit social security number in format xxx xx xxxx firstname string no first name of the subject lastname string no last name of the subject maxaddressyears integer no filter out any addresses which are older than x years sample response 200 (data found) { "result" { "persons" \[ { "name" { "prefix" "", "firstname" "john", "middlename" "", "lastname" "doe", "suffix" "", "publicfirstseendate" "1970 01 01" }, "ssn" "535 71 1319", "ssndates" "2011", "ssnlocation" "washington", "ssnalternatelocation" "wa", "socialsecuritynumbers" \[ { "ssn" "535 71 1319", "dates" "2011", "location" "washington" } ], "dob" "1987 04 02", "age" 36, "dod" null, "datesofdeath" \[], "deathrecords" { "isdeceased" false }, "aliases" \[], "addresses" \[ { "referenceid" 1, "housenumber" "260", "streetpredirection" "e", "streetname" "flamingo", "streetpostdirection" "", "streettype" "rd", "unit" "330", "unittype" "unit", "city" "las vegas", "state" "nv", "county" "clark", "zip" "89169", "zip4" "0320", "latitude" "36 116396", "longitude" " 115 160554", "firstreporteddate" "2016 03 01", "lastreporteddate" "2023 07 01", "fulladdress" " flamingo rd, unit 330; las vegas, nv 89169 0320", "aliases" \[] }, { "referenceid" 2, "housenumber" "14510", "streetpredirection" "ne", "streetname" "35th", "streetpostdirection" "", "streettype" "st", "unit" "a6", "unittype" "apt", "city" "bellevue", "state" "wa", "county" "king", "zip" "98007", "zip4" "8538", "latitude" "47 641876", "longitude" " 122 146336", "firstreporteddate" "2014 04 14", "lastreporteddate" "2016 07 20", "fulladdress" "14510 ne 35th st, apt a6; bellevue, wa 98007 8538", "aliases" \[] }, { "referenceid" 3, "housenumber" "5220", "streetpredirection" "", "streetname" "190th", "streetpostdirection" "ne", "streettype" "pl", "unit" "", "unittype" null, "city" "sammamish", "state" "wa", "county" "king", "zip" "98074", "zip4" "4600", "latitude" "47 654966", "longitude" " 122 085789", "firstreporteddate" "2011 03 23", "lastreporteddate" "2014 04 05", "fulladdress" "5220 190th ne pl; sammamish, wa 98074 4600", "aliases" \[] }, { "referenceid" 4, "housenumber" "25092", "streetpredirection" "", "streetname" "farthing", "streetpostdirection" "", "streettype" "st", "unit" "117", "unittype" "apt", "city" "lake forest", "state" "ca", "county" "orange", "zip" "92630", "zip4" "4046", "latitude" "33 628212", "longitude" " 117 692618", "firstreporteddate" "2012 08 01", "lastreporteddate" "2017 06 27", "fulladdress" "25092 farthing st, apt 117; lake forest, ca 92630 4046", "aliases" \[] }, { "referenceid" 5, "housenumber" "7006", "streetpredirection" "", "streetname" "134th", "streetpostdirection" "ne", "streettype" "ave", "unit" "", "unittype" null, "city" "redmond", "state" "wa", "county" "king", "zip" "98052", "zip4" "9416", "latitude" "47 668227", "longitude" " 122 161166", "firstreporteddate" "2011 05 27", "lastreporteddate" "2012 08 05", "fulladdress" "7006 134th ne ave; redmond, wa 98052 9416", "aliases" \[] }, { "referenceid" 6, "housenumber" "19222", "streetpredirection" "", "streetname" "25th", "streetpostdirection" "se", "streettype" "ave", "unit" "", "unittype" null, "city" "bothell", "state" "wa", "county" "snohomish", "zip" "98012", "zip4" "6968", "latitude" "47 823123", "longitude" " 122 199060", "firstreporteddate" "2011 03 01", "lastreporteddate" "2018 11 16", "fulladdress" "19222 25th se ave; bothell, wa 98012 6968", "aliases" \[] }, { "referenceid" 7, "housenumber" "101", "streetpredirection" "e", "streetname" "san fernando", "streetpostdirection" "", "streettype" "st", "unit" "348", "unittype" "apt", "city" "san jose", "state" "ca", "county" "santa clara", "zip" "95112", "zip4" "7434", "latitude" "37 336245", "longitude" " 121 887077", "firstreporteddate" "2010 05 06", "lastreporteddate" "2011 03 24", "fulladdress" "101 e san fernando st, apt 348; san jose, ca 95112 7434", "aliases" \[] }, { "referenceid" 8, "housenumber" "101", "streetpredirection" "e", "streetname" "san fernando", "streetpostdirection" "", "streettype" "st", "unit" "", "unittype" null, "city" "san jose", "state" "ca", "county" "santa clara", "zip" "95112", "zip4" "7423", "latitude" "37 336245", "longitude" " 121 887077", "firstreporteddate" "2016 06 15", "lastreporteddate" "2019 01 22", "fulladdress" "101 e san fernando st; san jose, ca 95112 7423", "aliases" \[] }, { "referenceid" 9, "housenumber" "5220", "streetpredirection" "", "streetname" "190th", "streetpostdirection" "ne", "streettype" "pl", "unit" "", "unittype" null, "city" "redmond", "state" "wa", "county" "king", "zip" "98074", "zip4" "4600", "latitude" "47 654966", "longitude" " 122 085789", "firstreporteddate" "2012 10 24", "lastreporteddate" "2013 03 21", "fulladdress" "5220 190th ne pl; redmond, wa 98074 4600", "aliases" \[] }, { "referenceid" 10, "housenumber" "25092", "streetpredirection" "", "streetname" "farthing", "streetpostdirection" "", "streettype" "st", "unit" "117", "unittype" "apt", "city" "el toro", "state" "ca", "county" "orange", "zip" "92630", "zip4" "4046", "latitude" "33 628212", "longitude" " 117 692618", "firstreporteddate" "2012 08 07", "lastreporteddate" "2012 08 07", "fulladdress" "25092 farthing st, apt 117; el toro, ca 92630 4046", "aliases" \[] }, { "referenceid" 11, "housenumber" "650", "streetpredirection" "s", "streetname" "11th", "streetpostdirection" "", "streettype" "st", "unit" "", "unittype" null, "city" "san jose", "state" "ca", "county" "santa clara", "zip" "95112", "zip4" "2339", "latitude" "37 331552", "longitude" " 121 872374", "firstreporteddate" "2009 05 05", "lastreporteddate" "2010 05 06", "fulladdress" "650 s 11th st; san jose, ca 95112 2339", "aliases" \[] } ], "phonenumbers" \[ { "phonenumber" "(425) 787 2770", "company" "new cingular wireless pcs llc", "location" "seattle, wa", "phonetype" "wireless", "isconnected" true, "firstreporteddate" "2011 06 09", "lastreporteddate" "2023 07 01" }, { "phonenumber" "(408) 899 1451", "company" "metropcs inc", "location" "san francisco, ca", "phonetype" "wireless", "isconnected" true, "firstreporteddate" "2010 05 06", "lastreporteddate" "2010 05 06" } ], "emailaddresses" \[ { "emailaddress" "johndoe01\@gmail com" } ], "fullname" "john doe", "countystates" \[ { "county" "clark", "state" "nv", "aliasreferences" \[] }, { "county" "king", "state" "wa", "aliasreferences" \[] }, { "county" "orange", "state" "ca", "aliasreferences" \[] }, { "county" "snohomish", "state" "wa", "aliasreferences" \[] }, { "county" "santa clara", "state" "ca", "aliasreferences" \[] } ] } ] } } 200 (no data found) { "result" { "persons" \[] } } response body parameters parameter data type description name object person's name ssn string social security number ssndates string year associated with the ssn ssnlocation string location associated with the ssn ssnalternatelocation string alternative location associated with the ssn socialsecuritynumbers\[] string array of social security numbers dob string date of birth age integer person's age dod string date of death datesofdeath\[] array array of dates of death datesofdeath\[] dod string individual date of deaths deathrecords object death records associated with the ssn deathrecords isdeceased boolean indicates if the person is deceased or not aliases\[] array array of alias addresses\[] array array of addresses phonenumbers\[] array array of phone numbers emailaddresses\[] array array of email addresses emailaddresses\[] emailaddress string email address fullname string individual's full name countystates array array of country states person's name parameters name type description prefix string individual's name prefix firstname string individual's first name middlename string individual's middle name lastname string individual's last name suffix string individual's suffix publicfirstseendate string individual's public first seen date alias parameters name type description referenceid integer alias reference id prefix string alias name prefix firstname string alias first name middlename string alias middle name lastname string alias last name suffix string alias suffix publicfirstseendate string alias public first seen date fullname string alias full name addressreferences\[] array array of matched addresses for the alias addressreferences\[] addressreferenceid integer id of the referenced address addressreferences\[] fulladdress string full address of the referenced address social security number parameters name type description ssn string individual's social security number dates string dates used location string state where ssn was issued address parameter name type description referenceid integer address reference id housenumber string house number streetpredirection string street pre direction streetname string street name streetpostdirection string street post direction streettype string street type unit string unit (apartment, suite, etc ) unittype string type of unit city string city state string state county string county zip string zip code zip4 string zip+4 code latitude string latitude longitude string longitude firstreporteddate string first reported date lastreporteddate string last reported date fulladdress string full address aliases\[] array array of aliases matching the address aliases\[] aliasreferenceid integer id of the referenced alias aliases\[] aliasname string name of the referenced alias phone number parameter name type description phonenumber string phone number company string company associated with the phone number location string location of the phone number phonetype string type of phone isconnected boolean indicates if the phone is connected or not firstreporteddate string first reported date lastreporteddate string last reported date country state parameter name type description county string county state string state aliasreferences\[] array array of aliases matching the state and county aliasreferences\[] aliasreferenceid integer id of the referenced alias aliasreferences\[] aliasname string name of the referenced alias aliasreferences\[] addressreferences\[] array array of addresses matching the referenced alias aliasreferences\[] addressreferences\[] addressreferenceid integer id of the referenced address aliasreferences\[] addressreferences\[] fulladdress string full address of the referenced address sample error 400 (bad request) { "error" { "name" "error", "message" "\\"ssn\\" is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "\\"ssn\\" with value \\"(input value)\\" fails to match the required pattern /^(?!666|000|9\\\d{2})\\\d{3}(?!00)\\\d{2}(?!0{4})\\\d{4}$/", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 409 (upstream down) { "error" { "name" "error", "message" "upstream down", "status" 409, "reason" "error", "type" "conflict", "statuscode" "409" } } 500 (internal server error) { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "error", "statuscode" 500 } } 401 (authentication) { "message" "invalid authentication credentials" } error response parameters parameter description error this parameter contains the error error statuscode request status code from signzy error message the error message error status status of the api error reason reason for error error type type of the 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!