eIDV Advance API

introduction the eidv advance api enables real time electronic identity verification (eidv) of individual consumers in the u s using a combination of personal data points such as name, ssn, phone number, address, and date of birth the api cross checks each input field against authoritative databases and returns detailed match indicators for each field, helping businesses assess the accuracy and legitimacy of a user's identity this robust, data driven verification process plays a critical role in compliance, fraud prevention, and secure onboarding key benefits multi attribute identity verification using trusted u s data sources field level match indicators (e g , name match, ssn match, dob match) reduces risk of synthetic identity fraud and impersonation improves user trust and onboarding speed common use cases banking & financial services (kyc/cip) verify consumer identities during account opening, credit applications, or lending decisions to meet regulatory compliance online marketplaces & gig economy platforms confirm legitimacy of users, sellers, drivers, or service providers before activation on the platform cryptocurrency & fintech platforms perform identity verification during wallet creation or crypto trading onboarding, reducing regulatory and fraud risk healthcare registration confirm patient identity using ssn and dob to avoid duplicate records and insurance fraud insurance onboarding & claims validate the identity of policyholders or claimants during online application or payout processes e commerce or bnpl (buy now pay later) platforms use full or partial ssn based verification to determine if users are legitimate before extending credit or high value services sample curl curl location 'https //api signzy us/api/v3/us kyc/eidv advance' \\ \ header 'content type application/json' \\ \ header 'authorization ' \\ \ data raw '{ "ssn" "", "dob" "", "addressline1" "", "city" "", "state" "", "zip" "", "dob" "", "firstname" "", "middlename" "", "lastname" "", "driverlicense" "", "email" "", "phone" "" }' // production is not available as of nowcurl location 'https //api preproduction signzy us/api/v3/us kyc/eidv advance' \\ \ header 'content type application/json' \\ \ header 'authorization ' \\ \ data raw '{ "ssn" "", "dob" "", "addressline1" "", "city" "", "state" "", "zip" "", "firstname" "", "middlename" "", "lastname" "", "driverlicense" "", "email" "", "phone" "" }' request body parameters true false 168,0,123false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type minimum input requirements provide one or more of the following ssn, phone, email, full address (addressline1, city, state, zip), or (firstname, lastname, dob) sample response { "result" { "score" 93 31, "scoredescriptions" \[ "address match", "full name match", "full dob match", "full phone match", "email no match", "na", "city exact match", "first 3 digits match", "state exact match" ], "addressmatchtype" "match", "namematchtype" "match", "dobmatchtype" "match", "phonematchtype" "match", "emailmatchtype" "no match", "ssnmatchtype" "na", "citymatchtype" "match", "zipmatchtype" "partial match", "statematchtype" "match", "driverlicensematchtype" "no dl available on record" }, "reason" "request successful", "code" "s001" } response body parameters true false 223false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type match types values true falsefalse left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type guidelines to use it is recommended to base decisions primarily on the score and match type values as a general guideline, a score above 70 indicates a strong match the score descriptions offer additional context on the matching logic used but are not intended for automated decision making purposes for automated decision making, we recommend use our score and elemental match/partial & no match you can use score description as part of your review process in case of borderline cases score descriptions values address true falsefalse left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type name true false 387false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type date of birth true false 392false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type phone true false 396false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type email true false 397false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type ssn true false 400false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type city true false 401false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type zip true false 403false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type state true false 404false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type sample error e601 internal server error { "result" {}, "reason" "internal server error", "code" "e601" } e001 invalid regex { "result" {}, "reason" "bad request ssn must be 4 or 9 digits (numbers only)", "code" "e001" } \ { "result" {}, "reason" "bad request dob must be in mm/dd/yyyy", "code" "e001" } \ { "result" {}, "reason" "bad request \\"phone\\" with value \\"\<value>\\" fails to match the required pattern /^\\\d{10}$/", "code" "e001" } \ { "result" {}, "reason" "bad request \\"state\\" length must be 2 characters long", "code" "e001" } \ { "result" {}, "reason" "bad request \\"zip\\" with value \\"\<value>\\" fails to match the required pattern /^\\\d{5}$/", "code" "e001" } e001 empty required field { "result" {}, "reason" "minimum input not satisfied provide one or more of the following ssn, phone, email, full address (addressline1, city, state, zip), or (firstname, lastname, dob)", "code" "e002" } e401 upstream failure { "result" {}, "reason" "upstream error", "code" "e401" } error response parameters true falseleft unhandled content type left unhandled content type left false unhandled content type left false unhandled content type left false unhandled content type left false unhandled content type left false unhandled content type left false unhandled content type left unhandled content type unhandled content type error codes true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type success codes true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false 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 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!