Person Search - Advanced

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, legal indicators, associates, neighbours, relatives and household composition

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

API Input

curl --location 'https://api.signzy.us/api/v3/us/person-search-advance' \
--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": "[email protected]",
    "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

{
  "statusCode": 200,
  "code": "S001",
  "message": "",
  "result": {
    "persons": [
      {
        "id": "TAH-78234910",
        "name": {
          "prefix": "",
          "firstName": "James",
          "middleName": "Robert",
          "lastName": "Mitchell",
          "suffix": "",
          "rawNames": [
            {
              "firstName": "James",
              "middleName": "Robert",
              "lastName": "Mitchell"
            }
          ],
          "publicFirstSeenDate": "2005-03-15",
          "totalFirstSeenDate": "2001-07-22",
          "sources": {
            "name": "Credit Bureau",
            "reportedDate": "2023-11-01"
          }
        },
        "fullName": "James Robert Mitchell",
        "dob": "1982-08-14",
        "age": "41",
        "datesOfBirth": [
          {
            "dob": "1982-08-14",
            "age": "41"
          }
        ],
        "dobFirstSeen": "2003-01-10",
        "dobLastSeen": "2023-09-05",
        "datesOfDeath": [],
        "hasAdditionalData": "true",
        "isCurrentPropertyOwner": "true",
        "deathRecords": {
          "isDeceased": "false"
        },
        "akas": [
          {
            "prefix": "",
            "firstName": "Jim",
            "middleName": "R",
            "lastName": "Mitchell",
            "suffix": "",
            "rawNames": [
              {
                "firstName": "Jim",
                "middleName": "R",
                "lastName": "Mitchell"
              }
            ],
            "publicFirstSeenDate": "2010-06-01",
            "totalFirstSeenDate": "2008-04-15",
            "sources": {
              "name": "Voter Registration",
              "reportedDate": "2022-05-10"
            }
          }
        ],
        "locations": [
          {
            "city": "Austin",
            "state": "TX"
          }
        ],
        "addresses": [
          {
            "addressHash": "ADDR-001-HASH",
            "houseNumber": "4821",
            "streetPreDirection": "",
            "streetName": "Maple",
            "streetPostDirection": "",
            "streetType": "Ave",
            "unit": "",
            "unitType": "",
            "city": "Austin",
            "state": "TX",
            "county": "Travis",
            "zip": "78745",
            "zip4": "3301",
            "dpc": "",
            "latitude": "30.2240",
            "longitude": "-97.7793",
            "addressOrder": "1",
            "fullAddress": "4821 Maple Ave, Austin, TX 78745",
            "firstReportedDate": "2018-06-01",
            "lastReportedDate": "2024-02-15",
            "publicFirstSeenDate": "2018-06-01",
            "totalFirstSeenDate": "2018-06-01",
            "highRiskMarker": {
              "isHighRisk": "false",
              "sic": "",
              "addressType": "Residential"
            },
            "sources": {
              "name": "Utility Records",
              "reportedDate": "2024-02-15"
            },
            "propertyIndicator": "1",
            "bldgCode": "SF",
            "utilityCode": "E",
            "unitCount": "1",
            "phoneNumbers": [
              {
                "phoneNumber": "5124789023",
                "phoneType": "Landline"
              }
            ]
          },
          {
            "addressHash": "ADDR-002-HASH",
            "houseNumber": "302",
            "streetPreDirection": "N",
            "streetName": "Congress",
            "streetPostDirection": "",
            "streetType": "St",
            "unit": "5B",
            "unitType": "Apt",
            "city": "Austin",
            "state": "TX",
            "county": "Travis",
            "zip": "78701",
            "zip4": "1122",
            "dpc": "",
            "latitude": "30.2672",
            "longitude": "-97.7431",
            "addressOrder": "2",
            "fullAddress": "302 N Congress St Apt 5B, Austin, TX 78701",
            "firstReportedDate": "2012-03-10",
            "lastReportedDate": "2017-11-30",
            "publicFirstSeenDate": "2012-03-10",
            "totalFirstSeenDate": "2012-03-10",
            "highRiskMarker": {
              "isHighRisk": "false",
              "sic": "",
              "addressType": "Residential"
            },
            "sources": {
              "name": "Postal Records",
              "reportedDate": "2017-11-30"
            }
          }
        ],
        "phoneNumbers": [
          {
            "phoneNumber": "5129871234",
            "company": "AT&T",
            "location": "Austin, TX",
            "phoneType": "Mobile",
            "isConnected": "true",
            "latitude": "30.2672",
            "longitude": "-97.7431",
            "phoneOrder": "1",
            "firstReportedDate": "2015-04-22",
            "lastReportedDate": "2024-01-10",
            "publicFirstSeenDate": "2015-04-22",
            "totalFirstSeenDate": "2015-04-22",
            "sources": {
              "name": "Carrier Records",
              "reportedDate": "2024-01-10"
            }
          },
          {
            "phoneNumber": "5124789023",
            "company": "Spectrum",
            "location": "Austin, TX",
            "phoneType": "Landline",
            "isConnected": "false",
            "latitude": "",
            "longitude": "",
            "phoneOrder": "2",
            "firstReportedDate": "2018-06-01",
            "lastReportedDate": "2022-08-15",
            "publicFirstSeenDate": "2018-06-01",
            "totalFirstSeenDate": "2018-06-01",
            "sources": {
              "name": "Utility Records",
              "reportedDate": "2022-08-15"
            }
          }
        ],
        "emailAddresses": [
          {
            "emailAddress": "[email protected]",
            "emailOrdinal": "1",
            "nonBusiness": "1",
            "sources": {
              "name": "E-commerce",
              "reportedDate": "2020-09-12"
            }
          }
        ],
        "driversLicenseDetail": [],
        "propensityToPayScore": {
          "transactionId": "",
          "suffix": "",
          "firstName": "",
          "middleName": "",
          "lastName": "",
          "address": "",
          "city": "",
          "state": "",
          "zip": "",
          "zip4": "",
          "measures": []
        },
        "householdComposition": [
          {
            "id": "TAH-88234001",
            "isSpouse": "true",
            "isDeceased": "false",
            "fullName": "Sarah Lynn Mitchell",
            "name": {
              "prefix": "",
              "firstName": "Sarah",
              "middleName": "Lynn",
              "lastName": "Mitchell",
              "suffix": "",
              "rawNames": [
                {
                  "firstName": "Sarah",
                  "middleName": "Lynn",
                  "lastName": "Mitchell"
                }
              ],
              "publicFirstSeenDate": "2010-09-01",
              "totalFirstSeenDate": "2010-09-01",
              "sources": {
                "name": "Voter Registration",
                "reportedDate": "2023-10-01"
              }
            },
            "age": "39",
            "dob": "1984-04-22",
            "ssn": "XXX-XX-5678",
            "dod": "",
            "akas": [],
            "currentAddress": {
              "addressHash": "ADDR-001-HASH",
              "houseNumber": "4821",
              "streetPreDirection": "",
              "streetName": "Maple",
              "streetPostDirection": "",
              "streetType": "Ave",
              "unit": "",
              "unitType": "",
              "city": "Austin",
              "state": "TX",
              "county": "Travis",
              "zip": "78745",
              "zip4": "3301",
              "dpc": "",
              "addressOrder": "1",
              "latitude": "30.2240",
              "longitude": "-97.7793",
              "fullAddress": "4821 Maple Ave, Austin, TX 78745",
              "firstReportedDate": "2018-06-01",
              "lastReportedDate": "2024-02-15",
              "publicFirstSeenDate": "2018-06-01",
              "totalFirstSeenDate": "2018-06-01",
              "highRiskMarker": {
                "isHighRisk": "false",
                "sic": "",
                "addressType": "Residential"
              },
              "sources": {
                "name": "Utility Records",
                "reportedDate": "2024-02-15"
              },
              "propertyIndicator": "1"
            },
            "phone1": "5129871235",
            "phone1Type": "Mobile",
            "phone1FirstReported": "2016-03-10",
            "phone1LastReported": "2024-01-05",
            "email1": "[email protected]",
            "isCurrentPropertyOwner": "true",
            "sources": {
              "name": "Credit Bureau",
              "reportedDate": "2023-11-01"
            }
          }
        ],
        "relativesSummary": [
          {
            "id": "TAH-77100234",
            "prefix": "",
            "firstName": "David",
            "middleName": "",
            "lastName": "Mitchell",
            "suffix": "",
            "dob": "1955-12-03",
            "isPrivate": "false",
            "isDeceased": "false",
            "relativeLevel": "1",
            "relativeType": "Father",
            "spouse": "false",
            "sharedHouseholdIds": [],
            "score": "98",
            "oldSpouse": "false",
            "city": "San Antonio",
            "state": "TX",
            "sources": {
              "name": "Family Records",
              "reportedDate": "2022-06-15"
            }
          },
          {
            "id": "TAH-77100235",
            "prefix": "",
            "firstName": "Carol",
            "middleName": "Ann",
            "lastName": "Mitchell",
            "suffix": "",
            "dob": "1958-07-19",
            "isPrivate": "false",
            "isDeceased": "false",
            "relativeLevel": "1",
            "relativeType": "Mother",
            "spouse": "false",
            "sharedHouseholdIds": [],
            "score": "97",
            "oldSpouse": "false",
            "city": "San Antonio",
            "state": "TX",
            "sources": {
              "name": "Family Records",
              "reportedDate": "2022-06-15"
            }
          }
        ],
        "associatesSummary": [
          {
            "id": "TAH-66100401",
            "prefix": "",
            "firstName": "Michael",
            "middleName": "T",
            "lastName": "Harris",
            "suffix": "",
            "dob": "1980-11-30",
            "isPrivate": "false",
            "isDeceased": "false",
            "score": "82",
            "sources": {
              "name": "Business Records",
              "reportedDate": "2021-04-20"
            }
          }
        ],
        "associates": [
          {
            "id": "TAH-66100401",
            "name": {
              "prefix": "",
              "firstName": "Michael",
              "middleName": "T",
              "lastName": "Harris",
              "suffix": "",
              "rawNames": [
                {
                  "firstName": "Michael",
                  "middleName": "T",
                  "lastName": "Harris"
                }
              ],
              "publicFirstSeenDate": "2008-02-14",
              "totalFirstSeenDate": "2006-09-01",
              "sources": {
                "name": "Business Records",
                "reportedDate": "2021-04-20"
              }
            },
            "fullName": "Michael T Harris",
            "dob": "1980-11-30",
            "age": "43",
            "datesOfBirth": [
              {
                "dob": "1980-11-30",
                "age": "43"
              }
            ],
            "dobFirstSeen": "2005-01-01",
            "dobLastSeen": "2023-07-01",
            "datesOfDeath": [],
            "akas": [],
            "locations": [
              {
                "city": "Austin",
                "state": "TX"
              }
            ],
            "addresses": [
              {
                "addressHash": "ADDR-ASC-001",
                "houseNumber": "900",
                "streetPreDirection": "",
                "streetName": "Lamar",
                "streetPostDirection": "",
                "streetType": "Blvd",
                "unit": "",
                "unitType": "",
                "city": "Austin",
                "state": "TX",
                "county": "Travis",
                "zip": "78703",
                "zip4": "",
                "dpc": "",
                "latitude": "30.2700",
                "longitude": "-97.7580",
                "addressOrder": "1",
                "fullAddress": "900 Lamar Blvd, Austin, TX 78703",
                "firstReportedDate": "2016-05-01",
                "lastReportedDate": "2024-01-01",
                "publicFirstSeenDate": "2016-05-01",
                "totalFirstSeenDate": "2016-05-01",
                "highRiskMarker": {
                  "isHighRisk": "false",
                  "sic": "",
                  "addressType": "Residential"
                },
                "sources": {
                  "name": "Business Records",
                  "reportedDate": "2021-04-20"
                }
              }
            ],
            "phoneNumbers": [
              {
                "phoneNumber": "5124561890",
                "company": "T-Mobile",
                "location": "Austin, TX",
                "phoneType": "Mobile",
                "isConnected": "true",
                "latitude": "",
                "longitude": "",
                "phoneOrder": "1",
                "firstReportedDate": "2017-03-01",
                "lastReportedDate": "2024-01-01",
                "publicFirstSeenDate": "2017-03-01",
                "totalFirstSeenDate": "2017-03-01",
                "sources": {
                  "name": "Carrier Records",
                  "reportedDate": "2024-01-01"
                }
              }
            ],
            "emailAddresses": [],
            "driversLicenseDetail": [],
            "hasAdditionalData": "true",
            "propensityToPayScore": {
              "transactionId": "",
              "suffix": "",
              "firstName": "",
              "middleName": "",
              "lastName": "",
              "address": "",
              "city": "",
              "state": "",
              "zip": "",
              "zip4": "",
              "measures": []
            },
            "deathRecords": {
              "isDeceased": "false"
            }
          }
        ],
        "neighborsSummary": [
          {
            "id": "TAH-55200111",
            "firstName": "Linda",
            "middleName": "",
            "lastName": "Torres",
            "dob": "1977-03-05",
            "city": "Austin",
            "state": "TX",
            "zip": "78745",
            "age": "47",
            "email": "[email protected]",
            "sources": {
              "name": "Postal Records",
              "reportedDate": "2023-12-01"
            }
          }
        ],
        "neighbors": [
          {
            "id": "TAH-55200111",
            "name": {
              "prefix": "",
              "firstName": "Linda",
              "middleName": "",
              "lastName": "Torres",
              "suffix": "",
              "rawNames": [
                {
                  "firstName": "Linda",
                  "lastName": "Torres"
                }
              ],
              "publicFirstSeenDate": "2015-01-01",
              "totalFirstSeenDate": "2015-01-01",
              "sources": {
                "name": "Postal Records",
                "reportedDate": "2023-12-01"
              }
            },
            "fullName": "Linda Torres",
            "dob": "1977-03-05",
            "age": "47",
            "datesOfBirth": [
              {
                "dob": "1977-03-05",
                "age": "47"
              }
            ],
            "dobFirstSeen": "",
            "dobLastSeen": "",
            "datesOfDeath": [],
            "akas": [],
            "locations": [
              {
                "city": "Austin",
                "state": "TX"
              }
            ],
            "addresses": [
              {
                "addressHash": "ADDR-NBR-001",
                "houseNumber": "4819",
                "streetPreDirection": "",
                "streetName": "Maple",
                "streetPostDirection": "",
                "streetType": "Ave",
                "unit": "",
                "unitType": "",
                "city": "Austin",
                "state": "TX",
                "county": "Travis",
                "zip": "78745",
                "zip4": "",
                "dpc": "",
                "latitude": "30.2239",
                "longitude": "-97.7792",
                "addressOrder": "1",
                "fullAddress": "4819 Maple Ave, Austin, TX 78745",
                "firstReportedDate": "2015-01-01",
                "lastReportedDate": "2023-12-01",
                "publicFirstSeenDate": "2015-01-01",
                "totalFirstSeenDate": "2015-01-01",
                "highRiskMarker": {
                  "isHighRisk": "false",
                  "sic": "",
                  "addressType": "Residential"
                },
                "sources": {
                  "name": "Postal Records",
                  "reportedDate": "2023-12-01"
                }
              }
            ],
            "phoneNumbers": [
              {
                "phoneNumber": "5127654321",
                "company": "Verizon",
                "location": "Austin, TX",
                "phoneType": "Mobile",
                "isConnected": "true",
                "latitude": "",
                "longitude": "",
                "phoneOrder": "1",
                "firstReportedDate": "2016-08-01",
                "lastReportedDate": "2023-12-01",
                "publicFirstSeenDate": "2016-08-01",
                "totalFirstSeenDate": "2016-08-01",
                "sources": {
                  "name": "Carrier Records",
                  "reportedDate": "2023-12-01"
                }
              }
            ],
            "emailAddresses": [
              {
                "emailAddress": "[email protected]",
                "emailOrdinal": "1",
                "nonBusiness": "1",
                "sources": {
                  "name": "E-commerce",
                  "reportedDate": "2021-06-10"
                }
              }
            ],
            "driversLicenseDetail": [],
            "hasAdditionalData": "false",
            "propensityToPayScore": {
              "transactionId": "",
              "suffix": "",
              "firstName": "",
              "middleName": "",
              "lastName": "",
              "address": "",
              "city": "",
              "state": "",
              "zip": "",
              "zip4": "",
              "measures": []
            }
          }
        ]
      }
    ],
    "counts": {
      "businessRecords": "3",
      "debtRecords": "1",
      "evictionRecords": "0",
      "foreclosureRecords": "0",
      "foreclosureV2Records": "0",
      "professionalLicenseRecords": "2",
      "expectedCount": "1"
    },
    "resultsCount": "1",
    "searchCriteria": [
      {
        "field": "firstName",
        "value": "James"
      },
      {
        "field": "lastName",
        "value": "Mitchell"
      }
    ],
    "requestId": "REQ-20260330-001",
    "requestType": "PersonSearch"
  }
}

API Output Schema

Root Level :

Field	Description	Data Type
statusCode	HTTP status code	Number
code	Internal response code	String
message	Response message	String
result	Main response payload	Object

Result Object :

Field	Description	Data Type
result.persons[]	List of matched persons	Array
result.counts	Summary counts of records	Object
result.resultsCount	Number of results returned	String
result.searchCriteria[]	Input search parameters	Array
result.requestId	Unique request ID	String
result.requestType	Type of request	String

PERSON OBJECT (result.persons[]) :

Field	Description	Data Type
id	Unique person ID	String
fullName	Full name of person	String
name	Structured name object	Object
dob	Primary date of birth	Date
age	Age of person	String
datesOfBirth[]	All DOB records	Array
dobFirstSeen	First seen DOB date	Date
dobLastSeen	Last seen DOB date	Date
datesOfDeath[]	Death records	Array
hasAdditionalData	Additional data flag	Boolean (String)
isCurrentPropertyOwner	Property ownership flag	Boolean (String)
deathRecords	Death info	Object
akas[]	Alternate names	Array
locations[]	Known locations	Array
addresses[]	Address records	Array
phoneNumbers[]	Phone records	Array
emailAddresses[]	Email records	Array
driversLicenseDetail[]	DL info	Array
propensityToPayScore	Payment score info	Object
householdComposition[]	Household members	Array
relativesSummary[]	Relatives summary	Array
associatesSummary[]	Associates summary	Array
associates[]	Detailed associates	Array
neighborsSummary[]	Neighbors summary	Array
neighbors[]	Detailed neighbors	Array

NAME OBJECT :

Field	Description	Data Type
prefix	Title	String
firstName	First name	String
middleName	Middle name	String
lastName	Last name	String
suffix	Suffix	String
rawNames[]	Raw name variations	Array
publicFirstSeenDate	Public first seen date	Date
totalFirstSeenDate	Total first seen date	Date
sources	Source info	Object

DATES OF BIRTH OBJECT :

Field	Description	Data Type
dob	Date of birth	Date
age	Age	String

ADDRESS OBJECT :

Field	Description	Data Type
addressHash	Unique address ID	String
fullAddress	Full formatted address	String
houseNumber	House number	String
streetName	Street name	String
streetType	Street type	String
unit	Unit number	String
unitType	Unit type	String
city	City	String
state	State	String
county	County	String
zip	ZIP code	String
zip4	Extended ZIP	String
latitude	Latitude	String
longitude	Longitude	String
firstReportedDate	First reported date	Date
lastReportedDate	Last reported date	Date
addressOrder	Ranking/order	String
highRiskMarker	Risk info	Object
sources	Source info	Object
phoneNumbers[]	Phones linked to address	Array

PHONE OBJECT :

Field	Description	Data Type
phoneNumber	Phone number	String
company	Carrier name	String
location	Phone location	String
phoneType	Type (Mobile/Landline)	String
isConnected	Active status	Boolean (String)
firstReportedDate	First seen	Date
lastReportedDate	Last seen	Date
sources	Source info	Object

EMAIL OBJECT :

Field	Description	Data Type
emailAddress	Email ID	String
emailOrdinal	Ranking	String
nonBusiness	Personal/business flag	String
sources	Source info	Object

HOUSEHOLD OBJECT :

Field	Description	Data Type
id	Household member ID	String
fullName	Name	String
isSpouse	Spouse flag	Boolean (String)
dob	Date of birth	Date
age	Age	String
currentAddress	Address object	Object
phone1	Primary phone	String
email1	Email	String

COUNTS OBJECT :

Field	Description	Data Type
businessRecords	Count of business records	String
debtRecords	Count of debt records	String
evictionRecords	Count of evictions	String
foreclosureRecords	Count of foreclosures	String
professionalLicenseRecords	License records	String
expectedCount	Expected results	String

SEARCH CRITERIA OBJECT :

Field	Description	Data Type
field	Search field name	String
value	Search value	String

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@:.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!