US Residential Verification

Overview
The US Residential Verification API enables businesses to verify an individual's name, date of birth, and address in the USA without requiring the Social Security Number (SSN) or phone number. This API offers a seamless and secure verification process, ensuring accurate identity validation for various applications.
Key Features:
No SSN Required
: Provides flexibility by not mandating SSN for verification.
Optional Phone Number
: Phone number is not a mandatory field.
Comprehensive Verification
: Ensures all critical personal details are verified.
Use Cases:
Banking and Financial Services:
Streamline customer onboarding by verifying identity and address without needing SSN.
Reduce fraud by ensuring accurate information during account creation.
E-commerce:
Verify customer information to prevent fraudulent transactions and ensure secure deliveries.
Simplify account creation and checkout processes with easy verification.
Telecommunications:
Verify customer details for new account activations without the need for SSN.
Ensure accurate billing and communication by verifying address information.
Healthcare:
Verify patient information to ensure accurate medical records.
Simplify digital onboarding for new patients without requiring SSN.
API Details
To use this API, include an authorization token in your request header for secure access. The endpoint is POST https://api.example.com/us-residential-verification. The API expects a JSON request body with personal details including name, date of birth, address, and optional phone number and SSN
Sample cURL
PreProduction
Production
curl -s -L -X POST 'https://api.signzy.us/api/v3/global-kyc-verify/us/ssn' -H 'Authorization:<AUTH TOKEN>' -H 'Content-Type: application/json' --data-raw '{
  "firstName": "barbaraa",
  "lastName": "Miller",
  "dateOfBirth": "1974-08-21",
  "addressLine1": "123 Main St",
  "addressLine3": "Stratfordd",
  "addressLine4": "CT",
  "addressLine5": "06614",
  "emailAddress": "",
  "phoneNumber": "",
  "identityInformation": {
    "nationalIdNumber": "854125698"
  },
  "consent": true
}'
curl -s -L -X POST 'https://api.signzy.us/api/v3/global-kyc-verify/us/ssn' -H 'Authorization:<AUTH TOKEN>' -H 'Content-Type: application/json' --data-raw '{
  "firstName": "barbaraa",
  "lastName": "Miller",
  "dateOfBirth": "1974-08-21",
  "addressLine1": "123 Main St",
  "addressLine3": "Stratfordd",
  "addressLine4": "CT",
  "addressLine5": "06614",
  "emailAddress": "",
  "phoneNumber": "",
  "identityInformation": {
    "nationalIdNumber": "854125698"
  },
  "consent": true
}'
﻿
API Request Body
cURL
{
  "firstName": "barbaraa",
  "lastName": "Miller",
  "dateOfBirth": "1974-08-21",
  "addressLine1": "123 Main St",
  "addressLine3": "Stratfordd",
  "addressLine4": "CT",
  "addressLine5": "06614",
  "emailAddress": "",
  "phoneNumber": "",
  "identityInformation": {
    "nationalIdNumber": "854125698"
  },
  "consent": true
}
{
  "firstName": "barbaraa",
  "lastName": "Miller",
  "dateOfBirth": "1974-08-21",
  "addressLine1": "123 Main St",
  "addressLine3": "Stratfordd",
  "addressLine4": "CT",
  "addressLine5": "06614",
  "emailAddress": "",
  "phoneNumber": "",
  "identityInformation": {
    "nationalIdNumber": "854125698"
  },
  "consent": true
}
﻿
Request Body Parameters
Paramter Name
Data Type
Description
Mandatory
/ Optional
firstName
String
first name of individual
Mandatory
middleName
String
middle name of individual
Optional
lastName
String
last name of individual
Mandatory
dateofBirth
String
date of birth of individual in yyyy-mm-dd format
Mandatory
addressLine1
String
Street level address of individual
Mandatory
addressLine3
String
city of residence
Mandatory
addressLine4
String
state of residence
Mandatory
addressLine5
String
postal code associated with address
Mandatory
nationalIdNumber
String
social security number of individual, must be 9 digits looks
Optional
emailAddress
String
email address
Optional
phoneNumber
String
10 digit phone number of individual without country code
Optional
consent
Boolean
consent field
Mandatory
﻿
Response
200
{
    "result": {
        "verificationResult": {
            "firstName": true,
            "lastName": true,
            "dateOfBirth": true,
            "addressLine1": true,
            "addressLine3": true,
            "addressLine4": true,
            "addressLine5": true,
            "phoneNumber": "NA",
            "emailAddress": "NA",
            "nationalIdNumber": true
        }
    }
}

{
    "result": {
        "verificationResult": {
            "firstName": true,
            "lastName": true,
            "dateOfBirth": true,
            "addressLine1": true,
            "addressLine3": true,
            "addressLine4": true,
            "addressLine5": true,
            "phoneNumber": "NA",
            "emailAddress": "NA",
            "nationalIdNumber": true
        }
    }
}
﻿
Response Body parameters
Paramter Name
Data Type
Description
firstName
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
middleName
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
lastName
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
dateofBirth
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine1
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine3
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine4
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine5
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
nationalIdNumber
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
emailAddress
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
phoneNumber
String
The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
Error Code Mapping
400 (Bad Request)
401(Unauthorized)
403 (Forbidden)
500 (Internal Server Error)
409(Upstream Down
{
  "error": {
     "name": "error",
     "message": "Bad Input and description ",
     "status": 400,
     "reason": "VALIDATION_ERROR",
     "type": "Bad Request",
     "statusCode": 400
  }
}
{
  "error": {
     "name": "error",
     "message": "Bad Input and description ",
     "status": 400,
     "reason": "VALIDATION_ERROR",
     "type": "Bad Request",
     "statusCode": 400
  }
}
﻿
Field
Type
Description
name
string
Text displayed on the screen explaining error type.
reason
string
Reason for the error.
status
number
HTTP status code.
message
string
Error message indicating an upstream error.
type
string
Error type.
statusCode
number
Status code representing the error scenario.
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 [email protected]. 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!
﻿

Paramter Name	Data Type	Description	Mandatory / Optional
firstName	String	first name of individual	Mandatory
middleName	String	middle name of individual	Optional
lastName	String	last name of individual	Mandatory
dateofBirth	String	date of birth of individual in yyyy-mm-dd format	Mandatory
addressLine1	String	Street level address of individual	Mandatory
addressLine3	String	city of residence	Mandatory
addressLine4	String	state of residence	Mandatory
addressLine5	String	postal code associated with address	Mandatory
nationalIdNumber	String	social security number of individual, must be 9 digits looks	Optional
emailAddress	String	email address	Optional
phoneNumber	String	10 digit phone number of individual without country code	Optional
consent	Boolean	consent field	Mandatory

Paramter Name	Data Type	Description
firstName	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
middleName	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
lastName	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
dateofBirth	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine1	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine3	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine4	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
addressLine5	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
nationalIdNumber	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
emailAddress	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.
phoneNumber	String	The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources.

Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an upstream error.
type	string	Error type.
statusCode	number	Status code representing the error scenario.

Did this page help you?

Identity Fetch

US DL Verification