Identity Fill (v2)

Introduction

The Identity Fill (v2) API (US) enables the retrieval of verified customer information using minimal input—such as a phone number, dob, or SSN etc. It is designed to streamline digital onboarding processes by auto-filling application forms with accurate personal data, thereby reducing friction, minimizing manual errors, and significantly enhancing the overall user experience.

This API is especially useful in scenarios where rapid, secure identity verification is needed with minimal effort from the end user.

Key Benefits

Faster form completion with minimal input.

Improved conversion rates by reducing drop-offs during onboarding.

Accurate data prefill, minimizing typos or misinformation.

Reduced fraud risk by verifying identity from trusted sources.

Common Use Cases

Digital Onboarding for Financial Services

Prefill bank account opening, credit card, or loan applications using just phone number and SSN.

Accelerate KYC (Know Your Customer) checks for regulatory compliance.

E-commerce & Checkout Optimization

Autofill shipping and billing information to reduce cart abandonment.

Insurance Application Prefill

Populate insured's personal data (name, DOB, address) to reduce form fatigue and improve submission rates.

Telecom or Utility Service Enrollment

Streamline sign-up for phone, internet, or energy services using limited user input.

Identity Verification for Gig or Rental Platforms

Prefill background check and ID verification forms for faster user onboarding.

Healthcare Patient Registration

Populate intake forms securely with verified identity data using SSN & phone, reducing administrative overhead.

Sample cURL

Production

Pre-production

curl --location 'https://api.signzy.us/api/v3/us/identity-fill-v2' \
--header 'Content-Type: application/json' \
--header 'Authorization: ' \
--data-raw '{
    "ssn": "",
    "ssn4": ""
    "dob": "",
    "addressLine1": "",
    "addressLine2": "",
    "city": "",
    "state": "",
    "zip": "",
    "firstName": "",
    "middleName": "",
    "lastName": "",
    "driverLicense": "",
    "email": "",
    "phone": ""
}'

curl --location 'https://api-preproduction.signzy.us/api/v3/us/identity-fill-v2' \
--header 'Content-Type: application/json' \
--header 'Authorization: ' \
--data-raw '{
    "ssn": "",
    "dob": "",
    "addressLine1": "",
    "addressLine2": "",
    "city": "",
    "state": "",
    "zip": "",
    "firstName": "",
    "middleName": "",
    "lastName": "",
    "driverLicense": "",
    "email": "",
    "phone": ""
}'

Minimum Input Requirements :-

Provide one or more of the following:(phone ,dob), (phone , ssn), (firstName , ssn), (firstName , lastName, ssn), (firstName, lastName, phone), or (firstName, lastName, dob)

Request Body Parameters

Parameter	Data Type	Required	Description
ssn	String	Optional	Must be exactly 9 digits (numeric only). Example: 123456789.
dob	String	Optional	Must be in YYYY-MM-DD format. Validated to be a real date, not future, and not older than 200 years. Example: 1990-01-01.
addressLine1	String	Optional	House number, street name, or PO Box. Example: 123 Main Street.
addressLine2	String	Optional	Additional address information (Apartment, Unit, Suite).
city	String	Optional	City name. Example: SampleCity.
state	String	Optional	Must be 2 uppercase alphabets. Example: CA.
zip	String	Optional	Must be exactly 5 digits. Example: 90001.
firstName	String	Optional	Given name. Example: John.
middleName	String	Optional	Middle initial or blank. Example: M.
lastName	String	Optional	Family name. Example: Doe.
driverLicense	String	Optional	Driver’s license number (state-specific format allowed). Example: D1234567.
email	String	Optional	Must be a valid email format. Example: [email protected].
phone	String	Optional	Must be exactly 10 digits (numeric only). Example: 1234567890.

Sample Response

{
  "result": {
    "matches": [
      {
        "score": "100.00",
        "isResidential": "false",
        "isResidentialMessage": "",
        "addressHighRiskFlag": "",
        "addressHash": "",
        "firstName": {
          "value": "John",
          "matchTypeCode": "MATCH"
        },
        "middleName": {
          "value": "A",
          "matchTypeCode": "NA"
        },
        "lastName": {
          "value": "Doe",
          "matchTypeCode": "MATCH"
        },
        "name": {
          "prefix": "",
          "firstName": "John",
          "middleName": "A",
          "lastName": "Doe",
          "suffix": "",
          "rawNames": [
            "JOHN A DOE"
          ],
          "publicFirstSeenDate": "2020-01-01",
          "totalFirstSeenDate": "2016-01-01",
          "sourceSummary": ""
        },
        "ssn": {
          "value": "123-45-6789",
          "matchTypeCode": "MATCH"
        },
        "socialSecurityNumbers": [
          {
            "ssn": "123-45-6789",
            "dates": "",
            "location": "",
            "alternateLocation": "",
            "sourceSummary": ""
          }
        ],
        "dobMonth": {
          "value": "12",
          "matchTypeCode": "MATCH"
        },
        "dobDay": {
          "value": "10",
          "matchTypeCode": "MATCH"
        },
        "dobYear": {
          "value": "1985",
          "matchTypeCode": "MATCH"
        },
        "age": {
          "value": "39",
          "matchTypeCode": "NA"
        },
        "driverLicense": {
          "value": "XXXXXXX",
          "matchTypeCode": "NA"
        },
        "addresses": [
          {
            "value": "123 Main St; Sample City, CA 90001",
            "matchTypeCode": "NA"
          },
          {
            "value": "45 Oak Avenue, UNIT 4; Sample City, CA 90002",
            "matchTypeCode": "NA"
          }
        ],
        "cities": [
          {
            "value": "Sample City",
            "matchTypeCode": "NA"
          }
        ],
        "states": [
          {
            "value": "CA",
            "matchTypeCode": "NA"
          }
        ],
        "zips": [
          {
            "value": "90001",
            "matchTypeCode": "NA"
          }
        ],
        "addressHistory": [
          {
            "isDeliverable": "true",
            "isMergedAddress": "false",
            "isPublic": "true",
            "addressQualityCodes": [],
            "addressHash": "1234567890123456789",
            "houseNumber": "123",
            "streetPreDirection": "",
            "streetName": "Main",
            "streetPostDirection": "",
            "streetType": "St",
            "unit": "",
            "unitType": "",
            "city": "Sample City",
            "state": "CA",
            "county": "Sample County",
            "zip": "90001",
            "zip4": "0001",
            "dpc": "01",
            "latitude": "34.000000",
            "longitude": "-118.000000",
            "addressOrder": "1",
            "highRiskMarker": {
              "isHighRisk": "false",
              "sic": "",
              "addressType": ""
            },
            "propertyIndicator": "",
            "bldgCode": "",
            "utilityCode": "",
            "unitCount": "-1",
            "firstReportedDate": "2020-01-01",
            "lastReportedDate": "2025-01-01",
            "publicFirstSeenDate": "2021-01-01",
            "totalFirstSeenDate": "2021-01-01",
            "phoneNumbers": [],
            "neighbors": [],
            "neighborSummaryRecords": [],
            "fullAddress": "123 Main St; Sample City, CA 90001",
            "sourceSummary": ""
          }
        ],
        "phoneHistory": [
          {
            "phoneNumber": "(555) 123-4567",
            "company": "Sample Telecom",
            "location": "SAMPLECITYCA",
            "phoneType": "Wireless",
            "isConnected": "true",
            "isPublic": "true",
            "latitude": "34.000000",
            "longitude": "-118.000000",
            "phoneOrder": "1",
            "firstReportedDate": "2019-01-01",
            "lastReportedDate": "2025-01-01",
            "publicFirstSeenDate": "2020-01-01",
            "totalFirstSeenDate": "2019-01-01",
            "sourceSummary": ""
          }
        ],
        "emailHistory": [
          {
            "emailAddress": "[email protected]",
            "emailOrdinal": "1",
            "isPremium": "true",
            "nonBusiness": "1",
            "sourceSummary": ""
          }
        ],
        "emails": [
          {
            "value": "[email protected]",
            "matchTypeCode": "NA"
          }
        ],
        "phones": [
          {
            "value": "(555) 123-4567",
            "matchTypeCode": "MATCH"
          }
        ],
        "akas": [
          {
            "firstName": { "value": "Jon", "matchTypeCode": "NA" },
            "middleName": { "value": "", "matchTypeCode": "NA" },
            "lastName": { "value": "Doe", "matchTypeCode": "NA" }
          }
        ],
        "datesOfBirth": [
          {
            "dob": "1985-12-10",
            "age": "39",
            "sourceSummary": ""
          }
        ],
        "datesOfDeath": [],
        "deathRecords": {
          "isDeceased": "false",
          "sourceSummary": ""
        },
        "indicators": "",
        "isCurrentPropertyOwner": "Not Available",
        "driverLicenseDetails": [],
        "isPublic": "true",
        "isOptedOut": "false",
        "optOutDate": "1970-01-01"
      }
    ],
    "requestId": "1234567890abcdef"
  },
  "reason": "Request Successful",
  "code": "S001"
}

Response Body Parameters

Inside Each matches Object

Parameter	Data Type	Description
score	string	Match confidence score in percentage.
firstName	string	First name associated with the matched identity.
middleName	string	Middle name or middle initial of the matched identity.
lastName	string	Last name / family name of the matched identity.
name	object	Full name object containing prefix, suffix, and raw name variations.
ssn	string	Masked Social Security Number associated with the identity.
dob	string	Date of birth in YYYY-MM-DD format. (Derived from year, month, and day in the response.)
age	string	Age derived from the date of birth.
driverLicense	string	Masked driver’s license number, if available.

Address

Parameter	Data Type	Description
addresses	array of objects	List of known address strings associated with the individual.
addressHistory	array of objects	Structured address records including deliverability, geolocation, reporting dates, and formatted address.
cities	array of objects	List of cities associated with the matched identity.
states	array of objects	List of U.S. states associated with the identity.
zips	array of objects	List of ZIP codes associated with the identity.
isResidential	string	Indicates whether the address is a residential address.
addressHighRiskFlag	string	Indicates whether the address is marked as high-risk.

Phone

Parameter	Data Type	Description
phones	array of objects	Phone numbers associated with the identity (values masked or generic).
phoneHistory	array of objects	Historical phone metadata such as carrier, type, reporting dates, and connectivity status.

Email

Parameter	Data Type	Description
emails	array of objects	Email addresses associated with the identity.
emailHistory	array of objects	Historical email metadata such as first-seen dates and source information.

Additional Fields

Parameter	Data Type	Description
akas	array of objects	Known aliases or alternative name variations for the individual.
datesOfBirth	array	List of birthdates found from different sources.
datesOfDeath	array	Death record details, if available (empty if the person is alive).
deathRecords	object	Indicates whether the individual is deceased.
indicators	string	Additional verification or risk indicators.
isPublic	string	Indicates if the data is publicly available.
isOptedOut	string	Indicates whether the individual has opted out of data reporting.
optOutDate	string	Date associated with the opt-out request.
isCurrentPropertyOwner	string	Indicates property ownership status, if available.

Sample Error

{
    "result": {},
    "reason": "Data Not Found",
    "code": "E301"
}

Error Response Parameters

Parameter	Description
result	Empty result object
reason	Reason for error
status	Status of the api
code	Error code from Signzy

Error Codes

HTTP Status Code	Error Code	Description
400	E001	Bad Request
401	E1001	Unauthorized Access
403	E201	Forbidden
404	E301	Data Not Found
409	E401	Upstream error
429	E501	Rate Limit Exceeded
500	E601	Internal Server Error
503	E701	Service Unavailable
504	E801	Timeout

Success Codes

HTTP Status Code	Success Code	Description
200	S001	Request Successful.
200	S003	Data not Found on source.

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!