--- title: Person Search slug: us-apis/person-search docTags: createdAt: 2024-12-03T17:12:01.849Z --- # 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 and legal indicators. The API supports investigative, KYC, fraud detection, and customer intelligence applications # 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 Person Search can be used in a variety of ways. If you are searching for a specific individual user can use combinations such as: - SSN - First Name + Last Name - First Name + Last Name + Address - First Name + Last Name +DOB User can also search on specific attributes to see individuals shown associated with that attributes: - Phone - Email - Address **Minimum Input Requirement** (Any one of the following) - firstName + lastName - ssn - phone - email - addresses (addressLine1 + addressLine2 with State and ZIP Code) - driverLicenseNumber + driverLicenseState ## API Input :::CodeblockTabs Production ```curl curl --location 'https://api.signzy.us/api/v3/us/person-search' \ --header 'Authorization: ' \ --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": "john.d@example.com", "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 }' ``` Pre-Production ```curl curl --location 'https://api-preproduction.signzy.us/api/v3/us/person-search' \ --header 'Authorization: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "firstName": "John", "middleName": "A", "lastName": "Doe", "ssn": "123456789", "dob": "1990-02-30", "age": 36, "ageRangeMinAge": 10, "ageRangeMaxAge": 50, "email": "john.d@example.com", "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 ```json { "result": { "persons": [ { "id": "G5789359913988571971", "name": { "prefix": "", "firstName": "John", "middleName": "A", "lastName": "Doe", "suffix": "", "rawNames": [ "John A" ], "publicFirstSeenDate": "2020-07-12", "totalFirstSeenDate": "2016-06-12", "sourceSummary": "" }, "ssn": "123-12-xxxx", "socialSecurityNumbers": [ { "ssn": "123-12-xxxx", "sourceSummary": "" } ], "ssnFirstSeen": "2016-07-08", "ssnLastSeen": "2024-29-12", "dob": "1990-02-XX", "age": 35, "datesOfBirth": [ { "dob": "1990-02-XX", "age": 35, "sourceSummary": "" }, { "dob": "", "age": 35, "sourceSummary": "" }, { "dob": "2000-01-XX", "age": 25, "sourceSummary": "" } ], "dobFirstSeen": "2016-07-08", "dobLastSeen": "2024-12-29", "datesOfDeath": [], "akas": [ { "prefix": "", "firstName": "John", "middleName": "", "lastName": "Doe", "suffix": "", "rawNames": [ "John Doe" ], "publicFirstSeenDate": "2020-11-03", "totalFirstSeenDate": "2016-12-06", "sourceSummary": "" }, { "prefix": "", "firstName": "John", "middleName": "", "lastName": "Doe", "suffix": "", "rawNames": [ "Doe, John", "JOHN DOE" ], "publicFirstSeenDate": "2022-09-29", "totalFirstSeenDate": "2022-09-29", "sourceSummary": "" }, { "prefix": "", "firstName": "John", "middleName": "Arnold", "lastName": "Doe", "suffix": "", "rawNames": [ "DOE, JOHN ARNOLD", "JOHN ARNOLD DOE" ], "publicFirstSeenDate": "2023-04-18", "totalFirstSeenDate": "2023-04-18", "sourceSummary": "" } ], "locations": [ { "city": "Aurora", "state": "IL" }, { "city": "Naperville", "state": "IL" }, { "city": "Northbrook", "state": "IL" }, { "city": "Chicago", "state": "IL" }, { "city": "Hudson Falls", "state": "NY" }, { "city": "Plymouth", "state": "MA" } ], "addresses": [ { "addressHash": "5342744394334380123", "houseNumber": "1234", "streetPreDirection": "S", "streetName": "Michigan Ave", "streetPostDirection": "", "streetType": "Ave", "unit": "", "unitType": "", "city": "Chicago", "state": "IL", "county": "Cook", "zip": "60411", "zip4": "3702", "dpc": "96", "latitude": "41.878175", "longitude": "- 87.629825", "addressOrder": 1, "highRiskMarker": { "isHighRisk": false, "sic": "", "addressType": "" }, "firstReportedDate": "2020-01-01", "lastReportedDate": "2025-07-01", "publicFirstSeenDate": "2021-12-08", "totalFirstSeenDate": "2021-12-08", "fullAddress": "1234, S Michigan Ave, Chicago, IL 60411-3702", "sourceSummary": "" }, { "addressHash": "-4155233217638734947", "houseNumber": "1234", "streetPreDirection": "", "streetName": "Station", "streetPostDirection": "", "streetType": "Blvd", "unit": "123", "unitType": "UNIT", "city": "Aurora", "state": "IL", "county": "Dupage", "zip": "60504", "zip4": "2136", "dpc": "14", "latitude": "41.768615", "longitude": "-88.213799", "addressOrder": 2, "highRiskMarker": { "isHighRisk": false, "sic": "", "addressType": "" }, "firstReportedDate": "2020-01-01", "lastReportedDate": "2023-02-06", "publicFirstSeenDate": "2021-03-25", "totalFirstSeenDate": "2021-02-26", "fullAddress": "1234 Station Blvd, UNIT 123; Aurora, IL 60504-2136", "sourceSummary": "" }, { "addressHash": "-8602062154728889716", "houseNumber": "1234", "streetPreDirection": "", "streetName": "Bromley", "streetPostDirection": "", "streetType": "Ln", "unit": "", "unitType": "", "city": "Aurora", "state": "IL", "county": "Dupage", "zip": "60502", "zip4": "6520", "dpc": "77", "latitude": "41.778572", "longitude": "-88.236893", "addressOrder": 3, "highRiskMarker": { "isHighRisk": false, "sic": "", "addressType": "" }, "firstReportedDate": "2020-08-11", "lastReportedDate": "2020-08-11", "publicFirstSeenDate": "2020-03-11", "totalFirstSeenDate": "2020-09-24", "fullAddress": "1234 Bromley Ln; Aurora, IL 60502-6520", "sourceSummary": "" } ], "phoneNumbers": [ { "phoneNumber": "(123) 123-1234", "company": "T-Mobile USA Inc", "location": "CHICAGO, IL", "phoneType": "Wireless", "isConnected": true, "latitude": "42.17201", "longitude": "-87.84785", "phoneOrder": 1, "firstReportedDate": "2019-08-01", "lastReportedDate": "2025-07-01", "publicFirstSeenDate": "2020-10-28", "totalFirstSeenDate": "2019-09-15", "sourceSummary": "" } ], "emailAddresses": [ { "emailAddress": "john.d@example.com", "emailOrdinal": 1, "nonBusiness": 1, "sourceSummary": "" } ], "fullName": "John A Doe", "indicators": { "hasBankruptcyRecords": 0, "hasBusinessRecords": 0, "hasDivorceRecords": 0, "hasDomainsRecords": 0, "hasEvictionsRecords": 0, "hasFeinRecords": 0, "hasForeclosuresRecords": 0, "hasForeclosuresV2Records": 0, "hasJudgmentRecords": 0, "hasLienRecords": 0, "hasMarriageRecords": 0, "hasProfessionalLicenseRecords": 2, "hasPropertyRecords": 0, "hasVehicleRegistrationsRecords": 0, "hasWorkplaceRecords": 0, "hasDeaRecords": 0, "hasPropertyV2Records": 3, "hasUccRecords": 0, "hasUnbankedData": 2, "hasMobilePhones": 5, "hasLandLines": 6, "hasEmails": 7, "hasAddresses": 16, "hasCurrentAddresses": 1, "hasHistoricalAddresses": 15, "hasDebtRecords": 0 }, "driversLicenseDetail": [], "hasAdditionalData": false, "propensityToPayScore": { "transactionId": "", "suffix": "", "firstName": "", "middleName": "", "lastName": "", "address": "", "city": "", "state": "", "zip": "", "zip4": "", "measures": [] } } ], "counts": { "businessRecords": 0, "debtRecords": 0, "evictionRecords": 0, "foreclosureRecords": 0, "foreclosureV2Records": 0, "professionalLicenseRecords": 0, "expectedCount": 1 }, "resultsCount": 10, "searchCriteria": [], "requestId": "2b4af231-efcd-4a45-ba5f-a1234567be0e", "requestType": "PersonSearch", "isError": false, "error": { "inputErrors": [], "warnings": [] } }, "reason": "Request Successful", "code": "S001" } ``` ## API Output Schema | Field | Description | DataType | Required? | | ------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------- | --------- | | persons | Array of person objects containing detailed information about individuals | Array of objects | Yes | | persons.id | Unique identifier for the person (TahoeId) | String | Yes | | persons.name | Object containing name details of the person | Object | Yes | | persons.name.prefix | Prefix of the person's name | String | No | | persons.name.firstName | First name of the person | String | Yes | | persons.name.middleName | Middle name of the person | String | No | | persons.name.lastName | Last name of the person | String | Yes | | persons.name.suffix | Suffix of the person's name | String | No | | persons.name.rawNames | Array of raw name strings as they appear in source data | Array of strings | No | | persons.name.publicFirstSeenDate | Date when the name was first seen in public records | String (YYYY-MM-DD) | Yes | | persons.name.totalFirstSeenDate | Date when the name was first seen in any records | String | No | | persons.name.sourceSummary | Summary of the source data for the name | String | No | | persons.ssn | Social Security Number (partially masked) | String | Yes | | persons.socialSecurityNumbers | Array of SSN objects | Array of objects | Yes | | persons.socialSecurityNumbers.ssn | Social Security Number (partially masked) | String | Yes | | persons.socialSecurityNumbers.sourceSummary | Summary of the source data for the SSN | String | No | | persons.ssnFirstSeen | Date when the SSN was first seen | String | No | | persons.ssnLastSeen | Date when the SSN was last seen | String | No | | persons.dob | Date of birth (partially masked) | String | Yes | | persons.age | Age of the person | Integer | Yes | | persons.datesOfBirth | Array of date of birth objects | Array of objects | Yes | | persons.datesOfBirth.dob | Date of birth (partially masked) | String | Yes | | persons.datesOfBirth.age | Age associated with the date of birth | Integer | No | | persons.datesOfBirth.sourceSummary | Summary of the source data for the date of birth | String | No | | persons.dobFirstSeen | Date when the DOB was first seen | String | Yes | | persons.dobLastSeen | Date when the DOB was last seen | String | Yes | | persons.datesOfDeath | Array of objects | Array | Yes | | persons.datesOfDeath.deathRecords | Object | Object | No | | persons.datesOfDeath.deathRecords.isDeceased | identifier if person is deceased | Boolean | No | | persons.akas | Array of alias objects (also known as names) | Array of objects | Yes | | persons.akas.prefix | Prefix of the alias name | String | No | | persons.akas.firstName | First name of the alias | String | Yes | | persons.akas.middleName | Middle name of the alias | String | No | | persons.akas.lastName | Last name of the alias | String | Yes | | persons.akas.suffix | Suffix of the alias name | String | No | | persons.akas.rawNames | Array of raw alias name strings | Array of strings | Yes | | persons.akas.publicFirstSeenDate | Date when the alias was first seen in public records | String | No | | persons.akas.totalFirstSeenDate | Date when the alias was first seen in any records | String | No | | persons.akas.sourceSummary | Summary of the source data for the alias | String | No | | persons.locations | Array of location objects (city and state) | Array of objects | Yes | | persons.locations.city | City of the location | String | Yes | | persons.locations.state | State of the location | String | Yes | | persons.addresses | Array of address objects | Array of objects | Yes | | persons.addresses.addressHash | Unique hash for the address | String | Yes | | persons.addresses.houseNumber | House number of the address | String | Yes | | persons.addresses.streetPreDirection | Pre-directional indicator of the street | String | No | | persons.addresses.streetName | Name of the street | String | Yes | | persons.addresses.streetPostDirection | Post-directional indicator of the street | String | No | | persons.addresses.streetType | Type of street (e.g., Cir, Blvd) | String | Yes | | persons.addresses.unit | Unit or apartment number | String | No | | persons.addresses.unitType | Type of unit (e.g., APT, UNIT) | String | No | | persons.addresses.city | City of the address | String | Yes | | persons.addresses.state | State of the address | String | Yes | | persons.addresses.county | County of the address | String | Yes | | persons.addresses.zip | ZIP code of the address | String | Yes | | persons.addresses.zip4 | Four-digit ZIP code extension | String | No | | persons.addresses.dpc | Delivery Point Code | String | No | | persons.addresses.latitude | Latitude of the address | String | No | | persons.addresses.longitude | Longitude of the address | String | No | | persons.addresses.addressOrder | Order of the address in the list | Integer | Yes | | persons.addresses.highRiskMarker | Object indicating if the address is high risk | Object | Yes | | persons.addresses.highRiskMarker.isHighRisk | Indicates if the address is high risk | Boolean | Yes | | persons.addresses.highRiskMarker.sic | Standard Industrial Classification code | String | Yes | | persons.addresses.highRiskMarker.addressType | Type of address | String | Yes | | persons.addresses.firstReportedDate | Date when the address was first reported | String | No | | persons.addresses.lastReportedDate | Date when the address was last reported | String | No | | persons.addresses.publicFirstSeenDate | Date when the address was first seen in public records | String | No | | persons.addresses.totalFirstSeenDate | Date when the address was first seen in any records | String | No | | persons.addresses.fullAddress | Full formatted address string | String | Yes | | persons.addresses.sourceSummary | Summary of the source data for the address | String | No | | persons.phoneNumbers | Array of phone number objects | Array of objects | Yes | | persons.phoneNumbers.phoneNumber | Phone number | String | Yes | | persons.phoneNumbers.company | Phone service provider | String | Yes | | persons.phoneNumbers.location | Location associated with the phone number | String | Yes | | persons.phoneNumbers.phoneType | Type of phone (e.g., Wireless) | String | No | | persons.phoneNumbers.isConnected | Indicates if the phone number is connected | Boolean | Yes | | persons.phoneNumbers.latitude | Latitude associated with the phone number | String | No | | persons.phoneNumbers.longitude | Longitude associated with the phone number | String | No | | persons.phoneNumbers.phoneOrder | Order of the phone number in the list | Integer | Yes | | persons.phoneNumbers.firstReportedDate | Date when the phone number was first reported | String | No | | persons.phoneNumbers.lastReportedDate | Date when the phone number was last reported | String | No | | persons.phoneNumbers.publicFirstSeenDate | Date when the phone number was first seen in public records | String | No | | persons.phoneNumbers.totalFirstSeenDate | Date when the phone number was first seen in any records | String | No | | persons.phoneNumbers.sourceSummary | Summary of the source data for the phone number | String | No | | persons.emailAddresses | Array of email address objects | Array of objects | Yes | | persons.emailAddresses.emailAddress | Email address | String | Yes | | persons.emailAddresses.emailOrdinal | Order of the email address in the list | Integer | Yes | | persons.emailAddresses.nonBusiness | Indicates if the email is non-business | Integer | No | | persons.emailAddresses.sourceSummary | Summary of the source data for the email address | String | No | | persons.fullName | Full name of the person | String | Yes | | persons.indicators.hasBankruptcyRecords | Indicates whether bankruptcy records exist (count of records found). | Integer | Yes | | persons.indicators.hasBusinessRecords | Indicates whether business-related records exist. | Integer | Yes | | persons.indicators.hasDivorceRecords | Indicates whether divorce records exist. | Integer | Yes | | persons.indicators.hasDomainsRecords | Indicates whether domain registration records exist. | Integer | Yes | | persons.indicators.hasEvictionsRecords | Indicates whether eviction records exist. | Integer | Yes | | persons.indicators.hasFeinRecords | Indicates whether Federal Employer Identification Number (FEIN) records exist. | Integer | Yes | | persons.indicators.hasForeclosuresRecords | Indicates whether foreclosure records exist. | Integer | Yes | | persons.indicators.hasForeclosuresV2Records | Indicates whether updated/secondary foreclosure records exist. | Integer | Yes | | persons.indicators.hasJudgmentRecords | Indicates whether judgment records exist. | Integer | Yes | | persons.indicators.hasLienRecords | Indicates whether lien records exist. | Integer | Yes | | persons.indicators.hasMarriageRecords | Indicates whether marriage records exist. | Integer | Yes | | persons.indicators.hasProfessionalLicenseRecords | Indicates the number of professional license records. | Integer | Yes | | persons.indicators.hasPropertyRecords | Indicates whether property ownership records exist. | Integer | Yes | | persons.indicators.hasVehicleRegistrationsRecords | Indicates whether vehicle registration records exist. | Integer | Yes | | persons.indicators.hasWorkplaceRecords | Indicates whether workplace-related records exist. | Integer | Yes | | persons.indicators.hasDeaRecords | Indicates whether DEA (Drug Enforcement Administration) license records exist. | Integer | Yes | | persons.indicators.hasPropertyV2Records | Indicates updated/secondary property ownership records. | Integer | Yes | | persons.indicators.hasUccRecords | Indicates whether UCC (Uniform Commercial Code) filing records exist. | Integer | Yes | | persons.indicators.hasUnbankedData | Indicates whether unbanked/alternative financial data exists. | Integer | Yes | | persons.indicators.hasMobilePhones | Number of mobile phone records found. | Integer | Yes | | persons.indicators.hasLandLines | Number of landline phone records found. | Integer | Yes | | persons.indicators.hasEmails | Number of email address records found. | Integer | Yes | | persons.indicators.hasAddresses | Number of all addresses (current and historical) found. | Integer | Yes | | persons.indicators.hasCurrentAddresses | Number of current addresses found. | Integer | Yes | | persons.indicators.hasHistoricalAddresses | Number of historical addresses found. | Integer | Yes | | persons.indicators.hasDebtRecords | Indicates whether debt-related records exist. | Integer | Yes | | persons.driversLicenseDetail | Array of driver’s license details | Array | Yes | | persons.hasAdditionalData | Indicates if additional data is available | Boolean | Yes | | persons.propensityToPayScore | Object containing propensity to pay score details | Object | Yes | | persons.propensityToPayScore.transactionId | Transaction ID for the score | String | No | | persons.propensityToPayScore.suffix | Suffix for the score | String | No | | persons.propensityToPayScore.firstName | First name for the score | String | No | | persons.propensityToPayScore.middleName | Middle name for the score | String | No | | persons.propensityToPayScore.lastName | Last name for the score | String | No | | persons.propensityToPayScore.address | Address for the score | String | No | | persons.propensityToPayScore.city | City for the score | String | No | | persons.propensityToPayScore.state | State for the score | String | No | | persons.propensityToPayScore.zip | ZIP code for the score | String | No | | persons.propensityToPayScore.zip4 | Four-digit ZIP code extension for the score | String | No | | persons.propensityToPayScore.measures | Array of measures for the score | Array | Yes | | counts | Object containing counts of various record types | Object | Yes | | counts.businessRecords | Number of business records | Integer | Yes | | counts.debtRecords | Number of debt records | Integer | Yes | | counts.evictionRecords | Number of eviction records | Integer | Yes | | counts.foreclosureRecords | Number of foreclosure records | Integer | Yes | | counts.foreclosureV2Records | Number of foreclosure V2 records | Integer | Yes | | counts.professionalLicenseRecords | Number of professional license records | Integer | Yes | | resultsCount | Number of results returned | Integer | Yes | | searchCriteria | Array of search criteria used | Array | No | | requestId | Unique identifier for the request | String | Yes | | requestType | Type of request | String | Yes | | isError | Indicates if the request resulted in an error | Boolean | Yes | | error | Object containing error details | Object | Yes | | error.inputErrors | Array of input errors | Array | Yes | | error.warnings | Array of warning messages | Array of strings | Yes | ## 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 | :::hint{type="info"} # 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! :::