--- title: Verify Data-Based Identity Verification description: With the Verify Data-Based Identity Verification service, you can accesses and return consumer identities from thousands of databases for comprehensive coverage of US-based identities and non-US-based identities from select countries. The service returns match-level indicators for first name, last name, current addresses, Social Security or national identification number, date of birth, and mobile phone number. The service also compares submitted information of US-based identities to over 300 verification, validation, behavioral, relational, and known fraud alerts to assist in pinpointing suspicious and fraudulent identities. component: pingone-api page_id: pingone-api:verify:verify-data-based-identity-verification canonical_url: https://developer.pingidentity.com/pingone-api/verify/verify-data-based-identity-verification.html section_ids: verify-data-based-identity-verification-request-data-model: Verify data-based identity verification request data model assigning-admin-roles-and-permissions-to-this-service: Assigning admin roles and permissions to this service verify-data-based-identity-verification-response-data-model: Verify data-based identity verification response data model verify-data-based-identity-verification-response-data-model-data-zoo: Data Zoo response data model verify-serviceResponses-overview: serviceResponses Overview serviceresponses-object: serviceResponses object verify-data-based-identity-verification-response-data-model-transunion: TransUnion response data model --- # Verify Data-Based Identity Verification With the Verify Data-Based Identity Verification service, you can accesses and return consumer identities from thousands of databases for comprehensive coverage of US-based identities and non-US-based identities from select countries. The service returns match-level indicators for first name, last name, current addresses, Social Security or national identification number, date of birth, and mobile phone number. The service also compares submitted information of US-based identities to over 300 verification, validation, behavioral, relational, and known fraud alerts to assist in pinpointing suspicious and fraudulent identities. You can use `POST {{apiPath}}/v1/environments/{{envID}}/users/{{userID}}/dataBasedIdentityVerification` to compare the unverified data submitted in the request body to the many databases and return a confidence level of the match, raw data from the vendor, and data from best match source if available. You can also include Data-Based Identity Verification in your [Verify Policy](verify-policy.html). ## Verify data-based identity verification request data model For US-based identities, the service requires at minimum for verification either `name` (or `given_name` and `family_name`) and `national_id_number`, which is a Social Security Number, or `name` (or `given_name` and `family_name`) and `birth_date`. Personally identifiable information (PII) is not returned unless Social Security Number or birth date are an exact match, and given name and family name are either a partial match or an exact match. PII is the `bestMatch`, `creditBureau.subject.subjectRecord.indicative`, and `creditBureau.subject.subjectRecord.custom.idmanagerVerAnalysisV2.fraudAnalysis.location` objects. If Social Security Number is not provided in `requirements`, it is not returned. If `phone` is included in this request, it is *not* verified using SMS. This differs from the service behavior when `DATA_BASED_IDENTITY_VERIFICATION` is included in a [verify policy](verify-policy.html). ## Assigning admin roles and permissions to this service Admin role assignments determine access to PingOne APIs. When assigning admin roles to this service, refer to [PingOne Permissions by Service](../platform/reference/roles-and-permissions-in-pingone/permissions-by-service.html) for the service-specific permissions. You can also choose to assign admin roles based on particular service resources. Refer to [PingOne Permissions by Resource](../platform/reference/roles-and-permissions-in-pingone/permissions-by-resource.html) when assigning admin roles per service resources. Admin assignments to roles are set by: * [Automatic assignment for some roles](../platform/roles/predefined-roles.html#automatic-role-assignment). * [Group Role Assignments](../platform/group-role-assignments/group-role-assignments.html). * [User Role Assignments](../platform/users/user-role-assignments.html). Refer to [Roles Management](../platform/roles.html) for more information. | Property | Type | Required? | Mutable? | Description | | ----------------------------------------- | ------ | ----------------- | --------- | ------------------------------------------------------------------------- | | `requirements` | Object | Required | Mutable | Contains two or more objects that contain information used by the service | | `requirements.country_code.value` | String | Required | Immutable | Country code | | `requirements.given_name.value` | String | Required | Immutable | Given name | | `requirements.family_name.value` | String | Required | Immutable | Family name | | `requirements.address_street.value` | String | Required/Optional | Immutable | Number and street portion of the address | | `requirements.address_street_line2.value` | String | Required/Optional | Immutable | Second line for street of the address | | `requirements.address_city.value` | String | Required/Optional | Immutable | City portion of the address | | `requirements.address_state.value` | String | Required/Optional | Immutable | State portion of the address | | `requirements.address_zip.value` | String | Required/Optional | Immutable | ZIP Code portion of the address | | `requirements.birth_date.value` | String | Optional | Immutable | Birth date | | `requirements.national_id_number.value` | String | Required/Optional | Immutable | Social Security or national identifier number | | `requirements.phone.value` | String | Optional | Immutable | Mobile telephone number | ## Verify data-based identity verification response data model Response data models differ by vendor: * [Data Zoo response data model](#verify-data-based-identity-verification-response-data-model-data-zoo) * [TransUnion response data model](#verify-data-based-identity-verification-response-data-model-transunion) ### Data Zoo response data model Properties returned in `serviceResponses.verifications` and `serviceResponses.returnedData` vary by country. | Property | Type | Required? | Mutable? | Description | | --------------------------------------------------------- | --------- | --------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `countryCode` | String | N/A | Read-only | Two-character country code for the country. Refer to [Groups for identities outside the US](verify-policy.html#groups-for-identities-outside-the-us). | | `clientReference` | String | N/A | Read-only | Client reference, if given as input | | `reportingReference` | String | N/A | Read-only | Reference number generated, which is unique to each transaction | | `validationErrors` | String | N/A | Read-only | Returned with HTTP status code 400 when the request contains invalid or improperly formatted input data | | `matchStatus` | String | N/A | Read-only | Match status. Can be `Full Match 1+1 Verification`, `Full Match 2+2 Verification`, or `No Match` | | `searchErrorMessage` | String | N/A | Read-only | Error message returned querying the data source | | `safeHarbour` | Boolean | N/A | Read-only | Whether or not an identity was verified against two or more independent data sources to reach a high level of confidence | | `searchStatus` | String | N/A | Read-only | Search status. Can be `Successful` or `Not Successful` | | `serviceResponses` | Object | N/A | Read-only | Object containing the responses from each service checked. Refer to [serviceResponses overview](#verify-serviceResponses-overview). | | `serviceResponses.` `status` | Integer | N/A | Read-only | Status of all service responses. Can be: 0 - identityVerified TRUE, element verifications all TRUE; 1 - identityVerified TRUE, element verifications not all TRUE; 2 - identityVerified FALSE, sourceStatus SUCCESSFUL; 3 - identityVerified FALSE, sourceStatus NOT SUCCESSFUL | | `serviceResponses.` `sourceStatus` | String | N/A | Read-only | Status of the verification source. Can be: `Successful` or `Unsuccessful` | | `serviceResponses.` `errorMessage` | String | N/A | Read-only | Error message(s) from the data source, such as "Error querying data source" | | `serviceResponses.` `identityVerified` | Boolean | N/A | Read-only | Whether or not the identity is deemed verified | | `serviceResponses.` `safeHarbourScore` | String | N/A | Read-only | Safe Harbour score. Refer to [Safe Harbour Scores and Status](https://docs.datazoo.com/api/safe-harbour-scores-and-status). | | `serviceResponses.` `nameMatchScore` | String | N/A | Read-only | Score for matching name. Can be: `1.000` - matched; `0.000` - no match | | `serviceResponses.` `addressMatchScore` | String | N/A | Read-only | Score for matching address. Can be: `1.000` - matched; `0.000` - no match | | `serviceResponses.` `verifications` | Object | N/A | Read-only | Object that contains service-specific boolean indicators for individual verification checks | | `serviceResponses.` `verifications.addressElement1` | Boolean | N/A | Read-only | Whether or not full address element 1 matched | | `serviceResponses.` `verifications.addressElement2` | Boolean | N/A | Read-only | Whether or not full address element 2 matched | | `serviceResponses.` `verifications.addressElement3` | Boolean | N/A | Read-only | Whether or not full address element 3 matched | | `serviceResponses.` `verifications.addressElement4` | Boolean | N/A | Read-only | Whether or not full address element 4 matched | | `serviceResponses.` `verifications.addressElement5` | Boolean | N/A | Read-only | Whether or not full address element 5 matched | | `serviceResponses.` `verifications.bankVerificationNo` | Boolean | N/A | Read-only | Whether or not bank verification number matched | | `serviceResponses.` `verifications.city` | Boolean | N/A | Read-only | Whether or not city matched | | `serviceResponses.` `verifications.cpf` | Boolean | N/A | Read-only | Whether or not the Brazilian national identity card matched | | `serviceResponses.` `verifications.curp` | Boolean | N/A | Read-only | Whether or not the Mexican national identity card matched | | `serviceResponses.` `verifications.dateOfBirth` | Boolean | N/A | Read-only | Whether or not date of birth matched | | `serviceResponses.` `verifications.email` | Boolean | N/A | Read-only | Whether or not email matched | | `serviceResponses.` `verifications.emailAddress` | Boolean | N/A | Read-only | Whether or not email address matched | | `serviceResponses.` `verifications.firstName` | Boolean | N/A | Read-only | Whether or not first name matched | | `serviceResponses.` `verifications.fullAddress` | Boolean | N/A | Read-only | Whether or not full address matched | | `serviceResponses.` `verifications.fullName` | Boolean | N/A | Read-only | Whether or not full name matched | | `serviceResponses.` `verifications.gender` | Boolean | N/A | Read-only | Whether or not gender matched | | `serviceResponses.` `verifications.landlineNo` | Boolean | N/A | Read-only | Whether or not land line phone number matched | | `serviceResponses.` `verifications.lastName` | Boolean | N/A | Read-only | Whether or not last name matched | | `serviceResponses.` `verifications.middleName` | Boolean | N/A | Read-only | Whether or not middle name matched | | `serviceResponses.` `verifications.nationalIDNo` | Boolean | N/A | Read-only | Whether or not national identification number matched | | `serviceResponses.` `verifications.phoneNo` | Boolean | N/A | Read-only | Whether or not phone number matched | | `serviceResponses.` `verifications.postCode` | Boolean | N/A | Read-only | Whether or not postal code matched | | `serviceResponses.` `verifications.state` | Boolean | N/A | Read-only | Whether or not state matched | | `serviceResponses.` `verifications.street` | Boolean | N/A | Read-only | Whether or not street matched | | `serviceResponses.` `verifications.voterNo` | Boolean | N/A | Read-only | Whether or not voter number matched | | `serviceResponses.` `returnedData` | Object | N/A | Read-only | Object that contains metadata, including `category` and `source`, indicating the data provider used for verification | | `serviceResponses.` `returnedData.accountClass` | String | N/A | Read-only | Account class for Canada Residential | | `serviceResponses.` `returnedData.accountType` | String | N/A | Read-only | Account type for Canada Residential | | `serviceResponses.` `returnedData.activationDate` | String | N/A | Read-only | Activation date for Canada Residential | | `serviceResponses.` `returnedData.address` | String | N/A | Read-only | Full address of the individual. | | `serviceResponses.` `returnedData.altAddressMatchScore` | Object | N/A | Read-only | Match score for each address element (if configured) | | `serviceResponses.` `returnedData.altDobScore` | String | N/A | Read-only | Date of birth Matching Logic indicator (if configured) | | `serviceResponses.` `returnedData.altNameMatchScore` | Object | N/A | Read-only | Match score for each name element (if configured) | | `serviceResponses.` `returnedData.brandName` | String | N/A | Read-only | Brand name for Canada Residential | | `serviceResponses.` `returnedData.carrierName` | String | N/A | Read-only | Carrier name for Canada Residential | | `serviceResponses.` `returnedData.category` | String | N/A | Read-only | Data source type or category, such as telco or consumer | | `serviceResponses.` `returnedData.dpId` | String | N/A | Read-only | Delivery Point Identifier of the address | | `serviceResponses.` `returnedData.fullName` | String | N/A | Read-only | Full name of the individual - included or omitted based on the client's configured settings | | `serviceResponses.` `returnedData.nationalIdNo` | String | N/A | Read-only | National identification number from Denmark National ID service | | `serviceResponses.` `returnedData.PersonStatus` | String | N/A | Read-only | Person status from Denmark National ID service | | `serviceResponses.` `returnedData.phoneStatus` | String | N/A | Read-only | Phone status for Canada Residential | | `serviceResponses.` `returnedData.possibleDeceasedRecord` | Boolean | N/A | Read-only | Flag indicating Deceased Check of the identity owner | | `serviceResponses.` `returnedData.source` | String | N/A | Read-only | Identifies the data source used | | `serviceResponses.` `returnedData.subscriberId` | String | N/A | Read-only | Subscriber identification number for Canada Residential | | `remarks` | String\[] | N/A | Read-only | Array of remarks regarding any encountered issues or pre-validation errors. | #### serviceResponses Overview Each service returns its own self-contained response block, ensuring modular and source-specific verification results. Consumers of this API should handle varying response structures dynamically based on the requested services. Safe Harbour is the determination of verifying an identity owner against two independent data sources to reach a high level of confidence. A positive Safe Harbour Status can only be achieved when the identity owner's name is verified in at least two independent sources, in combination with a verified address or a verified date of birth in the same two independent sources. #### serviceResponses object The `serviceResponses` object in the API response contains verification results from one or more data sources, structured under their respective service names. Each service returns a distinct response block with service-specific data. Structure and behavior: * Each key within `serviceResponses` corresponds to a `service name`, representing an individual verification source. * Services may return data from a single source or multiple sources in a sequenced API call. * The structure of each service response varies, with fields such as `status`, `identityVerified`, and `safeHarbourScore` differing between services. * The `verifications` block contains service-specific boolean indicators for individual verification checks such as `addressElement1`, `dateOfBirth`, `firstName`. * The `returnedData` block provides metadata, including `category` and `source`, indicating the data provider used for verification. ### TransUnion response data model Ping Identity reports `confidence` levels of verification as: `HIGH`, `MEDIUM`, and `LOW`. Refer to [data object for DATA\_BASED\_IDENTITY\_VERIFICATION + TRANSUNION](verification-metadata.html#verify-data-object-for-type-data_based_identity_verification-and-provider-transunion) for the correlation between `confidence` returned by this operation and the `riskIndicator` returned by [Read One Verification Metadata](verification-metadata/read-one-verification-metadata.html). | Property | Type | Required? | Mutable? | Description | | --------------------------------------------------------------------------------------------------------------------------------- | --------- | --------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `confidence` | String | N/A | Read-only | Confidence level of the match returned by the service. Can be `HIGH`, `MEDIUM`, or `LOW`. | | `bestMatch` | Object | N/A | Read-only | Contains the best match found for each property. | | `bestMatch.addressCity` | String | N/A | Read-only | City from the address. | | `bestMatch.addressState` | String | N/A | Read-only | State from the address. | | `bestMatch.addressStreet` | String | N/A | Read-only | Street from the address. | | `bestMatch.addressZip` | String | N/A | Read-only | ZIP Code from the address. | | `bestMatch.birthDate` | String | N/A | Read-only | Birthdate of the person. | | `bestMatch.firstName` | String | N/A | Read-only | First name of the person. | | `bestMatch.lastName` | String | N/A | Read-only | Last name of the person. | | `bestMatch.nationalIdNumber` | String | N/A | Read-only | Social Security number of the person. | | `bestMatch.phone` | String | N/A | Read-only | Phone. number of the person. | | `creditBureau` | Object | N/A | Read-only | Contains the results from the credit bureau. | | `creditBureau.subject.` `number` | String | N/A | Read-only | Index of the subject. | | `creditBureau.subject.` `subjectRecord` | Object | N/A | Read-only | Object containing the subject record. | | `creditBureau.subject.` `subjectRecord.fileNumber` | String | N/A | Read-only | Index of the file. | | `creditBureau.subject.` `subjectRecord.fileSummary.` `fileHitIndicator` | Object | N/A | Read-only | Type of file entry. | | `creditBureau.subject.` `subjectRecord.fileSummary.` `creditDataStatus.suppressed` | Boolean | N/A | Read-only | Whether or not the data provider provided no response within 28 days. | | `creditBureau.subject.` `subjectRecord.fileSummary.` `creditDataStatus.doNotPromote.indicator` | Boolean | N/A | Read-only | Whether or not the person opted out of promotional offers. | | `creditBureau.subject.` `subjectRecord.fileSummary.` `creditDataStatus.freeze.indicator` | Boolean | N/A | Read-only | Whether or not the person restricted access to their file. | | `creditBureau.subject.` `subjectRecord.fileSummary.` `creditDataStatus.minor` | Boolean | N/A | Read-only | Whether or not the person is a minor. | | `creditBureau.subject.` `subjectRecord.fileSummary.` `creditDataStatus.disputed` | Boolean | N/A | Read-only | Whether or not the person disputes the file entry. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `riskIndicator` | String | N/A | Read-only | Risk level. Can be `low`, `medium`, or `high`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `bestMatch` | String | N/A | Read-only | The `source` determined to provide the best match. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `verificationPoint` | Integer | N/A | Read-only | Numeric risk rating for the person equal to or greater than 0. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `lowerThreshold` | Integer | N/A | Read-only | Vendor-defined lower threshold of the medium risk verification point range, always 30. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `upperThreshold` | Integer | N/A | Read-only | Vendor-defined upper threshold of the medium risk verification point range, always 49. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `keyMessages` | Object\[] | N/A | Read-only | Array of key message objects. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `keyMessages.keyMessage.code` | String | N/A | Read-only | Code for the key message. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationSummary.` `keyMessages.keyMessage.text` | String | N/A | Read-only | Text for the key message. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location` | Object | N/A | Read-only | Location of the person. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.county.source` | String | N/A | Read-only | Source of the county, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.county.inputElement` | String | N/A | Read-only | Element from the input object used to find the location, such as `phoneNumber` or `zipCode`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.county.name` | String | N/A | Read-only | Name of the county associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.county.population` | String | N/A | Read-only | Population bracket, such as `inLargestMSA`, `over150`, `over35`, `over35`, or `notRequested` | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.county.city` | String | N/A | Read-only | Name of the city associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.county.state` | String | N/A | Read-only | Name of the state associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.zip.source` | String | N/A | Read-only | Source of the ZIP Code, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.zip.inputElement` | String | N/A | Read-only | Element from the input object used to find the ZIP Code, such as `phoneNumber` or `zipCode`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.zip.code` | String | N/A | Read-only | ZIP Code associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `location.zip.indicator` | String | N/A | Read-only | Whether the ZIP Code is literal or estimated. Can be `input`, `closest`, or `mostCommon`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `region.source` | String | N/A | Read-only | Source of the geographic information, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `region.zipVsCity` | String | N/A | Read-only | Result of comparing the source ZIP Code to the source city. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `region.zipVsState` | String | N/A | Read-only | Result of comparing the source ZIP Code to the source state. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `region.phoneVsState` | String | N/A | Read-only | Result of comparing the source phone number to the source state. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested` | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `region.phoneVsZIP` | String | N/A | Read-only | Result of comparing the source phone number to the source ZIP Code. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `region.phoneVsZIPDistance` | String | N/A | Read-only | Mileage between the phone number and ZIP Code. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.source` | Object | N/A | Read-only | Source of the employment information of the person, such as `input` (provided in the request), `file` (credit file), or `vendor`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `distance.source` | String | N/A | Read-only | Whether or not the person disputes the file entry. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location` | Object | N/A | Read-only | Location of the person. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.county.source` | String | N/A | Read-only | Source of the county, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.county.inputElement` | String | N/A | Read-only | Element from the input object used to find the location, such as `phoneNumber` or `zipCode`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.county.name` | String | N/A | Read-only | Name of the county associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.county.population` | String | N/A | Read-only | Population bracket, such as `inLargestMSA`, `over150`, `over35`, `over35`, or `notRequested` | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.county.city` | String | N/A | Read-only | Name of the city associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.county.state` | String | N/A | Read-only | Name of the state associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.zip.source` | String | N/A | Read-only | Source of the ZIP Code, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.zip.inputElement` | String | N/A | Read-only | Element from the input object used to find the ZIP Code, such as `phoneNumber` or `zipCode`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.zip.code` | String | N/A | Read-only | ZIP Code associated with the source `inputElement`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.location.zip.indicator` | String | N/A | Read-only | Whether the ZIP Code is literal or estimated. Can be `input`, `closest`, or `mostCommon`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.region.source` | String | N/A | Read-only | Source of the geographic information, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.region.zipVsCity` | String | N/A | Read-only | Result of comparing the source ZIP Code to the source city. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.region.zipVsState` | String | N/A | Read-only | Result of comparing the source ZIP Code to the source state. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.region.phoneVsState` | String | N/A | Read-only | Result of comparing the source phone number to the source state. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested` | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.region.phoneVsZIP` | String | N/A | Read-only | Result of comparing the source phone number to the source ZIP Code. Can be `valid`, `invalid`, `notAvailable`, `zipNotIssued`, `newZIP`, `notRequested`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `employment.region.phoneVsZIPDistance` | String | N/A | Read-only | Mileage between the phone number and ZIP Code. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `distance.source` | String | N/A | Read-only | Source of the distance, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `distance.minimum.` | String | N/A | Read-only | Minimum distance between home and business where the sub-element, `homeToBusinessPhone`, `homePhoneToBusinessZIP`, `homeZIPToBusinessPhone`, `homeToBusinessZIP`, or `noAnalysisReason`, indicates the comparison used to determine the minimum mileage. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.fraudAnalysis.` `distance.maximum.` | String | N/A | Read-only | Maximum distance between home and business where the sub-element, `homeToBusinessPhone`, `homePhoneToBusinessZIP`, `homeZIPToBusinessPhone`, `homeToBusinessZIP`, or `noAnalysisReason`, indicates the comparison used to determine the minimum mileage. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis` | Object\[] | N/A | Read-only | Object containing the identification verification results for each data source used in the analysis. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `source` | String | N/A | Read-only | Source of the information, such as `file` (credit file) or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `verificationStatus` | String | N/A | Read-only | Status of the verification for this source. Can be `insufficientInput`, `subjectFound`, `subjectNotFound`, `verificationDiscrepancy`, `privateListingFound`, `residentialListingFound`, `businessListingFound`, `listingWithNoNameFound`, `nonMailableAddressFound`, `phoneNotInput`, `unavailable`, `dataRestricted`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `firstNameVerification` | String | N/A | Read-only | First name verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `middleNameVerification` | String | N/A | Read-only | Middle name verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `lastNameVerification` | String | N/A | Read-only | Last name verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `nameSuffixVerification` | String | N/A | Read-only | Name suffix verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `currentAddressVerification` | String | N/A | Read-only | Current address verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `previousAddressVerification` | String | N/A | Read-only | Previous address verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `phoneNumberVerification` | String | N/A | Read-only | Phone number verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `ssnVerification` | String | N/A | Read-only | Sodial Security number verification. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `matchLastFour`, `inputNotAvailable`, `matchNotPerformed`, \`dataRestricted \`. | | `creditBureau.subject.` `subjectRecord.custom.` `idmanagerVerAnalysisV2.verificationAnalysis.` `dateOfBirthVerification` | String | N/A | Read-only | Date of birth verification results. Can be `notFound`, `noMatch`, `partialMatch`, `match`, `inputNotAvailable`, `lastFourMatch`, `dataRestricted`, `matchNotPerformed`. | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `code` | String | N/A | Read-only | Vendor code for the add-on product. | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `status` | String | N/A | Read-only | Status of the add-on product. Can be `clear`, `delivered`, `notAvailable`, `notAuthorized`. | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `highRiskFraudAlert.message.source` | String | N/A | Read-only | Source of the message, such as `input` (provided in the request) or `file` (credit file). | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `highRiskFraudAlert.message.code` | String | N/A | Read-only | Vendor code for the alert. | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `highRiskFraudAlert.message.text` | String | N/A | Read-only | Text of the alert. | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `idManagerVerification.searchStatus` | String | N/A | Read-only | Result of the subject search. Can be `clear`, `hit`, `unavailable`, `systemError`, `inputError`. | | `creditBureau.subject.` `subjectRecord.addOnProduct.` `idManagerVerification.returnMessage` | String | N/A | Read-only | Specifies how returned messages are displayed in the response. Can be `codes`, `text`, `codesAndText`. | | `creditBureau.subject.` `subjectRecord.indicative.` `address` | Object\[] | N/A | Read-only | Array of address objects, which shows addresses from various sources in chronological order. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.classification.type` | String | N/A | Read-only | Type of address, such as `conventional`, `apartment`, `poBox`, `ruralRoute`. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.classification.usps` | String | N/A | Read-only | Type of address as reported by USPS. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.dateReported.` `estimatedCentury` | Boolean | N/A | Read-only | Whether or not the century is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.dateReported.` `estimatedDay` | Boolean | N/A | Read-only | Whether or not the day is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.dateReported.` `estimatedMonth` | Boolean | N/A | Read-only | Whether or not the month is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.dateReported.` `estimatedYear` | Boolean | N/A | Read-only | Whether or not the year is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.dateReported.` `value` | String | N/A | Read-only | Date the address was reported. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.location.city` | String | N/A | Read-only | City of the address. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.location.state` | String | N/A | Read-only | State of the address. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.location.zipCode` | String | N/A | Read-only | ZIP Code or postal code of the address. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.qualifier` | String | N/A | Read-only | A qualifier of the address, such as `personal`. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.source` | String | N/A | Read-only | Source of the name, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.indicative.` `address.status` | String | N/A | Read-only | Status of the address, such as `current`, `previous`, or `secondPrevious`. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.street.name` | String | N/A | Read-only | Name of the street. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.street.number` | String | N/A | Read-only | Number on the street. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.street.type` | String | N/A | Read-only | Type of street, such as `LN` or `ST`. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.street.unit.number` | String | N/A | Read-only | Unit number at the address. | | `creditBureau.subject.` `subjectRecord.indicative.` `address.street.unit.type` | String | N/A | Read-only | Type of unit, such as `APT` or `STE`. | | `creditBureau.subject.` `subjectRecord.indicative.` `age.source` | String | N/A | Read-only | Source of the date of birth, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.indicative.` `age.value` | String | N/A | Read-only | Age of the person. | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth` | Object\[] | N/A | Read-only | Array of date of birth objects, which shows dates of birth from various sources. | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth.estimatedCentury` | Boolean | N/A | Read-only | Whether or not the century is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth.estimatedDay` | Boolean | N/A | Read-only | Whether or not the day is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth.estimatedMonth` | Boolean | N/A | Read-only | Whether or not the month is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth.estimatedYear` | Boolean | N/A | Read-only | Whether or not the year is estimated. | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth.source` | String | N/A | Read-only | Source of the date of birth, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.indicative.` `dateOfBirth.value` | String | N/A | Read-only | Date the address was reported. | | `creditBureau.subject.` `subjectRecord.indicative.` `gender.source` | String | N/A | Read-only | Source of the gender, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.indicative.` `gender.value` | String | N/A | Read-only | Gender of the person. | | `creditBureau.subject.` `subjectRecord.indicative.` `name` | Object\[] | N/A | Read-only | Array of name objects, which shows names from various sources. | | `creditBureau.subject.` `subjectRecord.indicative.` `name.person.first` | String | N/A | Read-only | Given name of the person. | | `creditBureau.subject.` `subjectRecord.indicative.` `name.person.generationalSuffix` | String | N/A | Read-only | Generational suffix of the person, such as `Junior` or `IV`. | | `creditBureau.subject.` `subjectRecord.indicative.` `name.person.last` | String | N/A | Read-only | Family name of the person. | | `creditBureau.subject.` `subjectRecord.indicative.` `name.person.middle` | String | N/A | Read-only | Middle name of the person. | | `creditBureau.subject.` `subjectRecord.indicative.` `name.source` | String | N/A | Read-only | Source of the name, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.indicative.` `name.qualifier` | String | N/A | Read-only | For business names, the type of name. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone` | Object\[] | N/A | Read-only | Array of phone number objects, which shows phone numbers from various sources. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone.number.areaCode` | String | N/A | Read-only | Area code of the phone number. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone.number.exchange` | String | N/A | Read-only | Exchange of the phone number. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone.number.qualifier` | String | N/A | Read-only | A qualifier of the phone number, such as `personal`. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone.number.suffix` | String | N/A | Read-only | Suffix, or station number, of the phone number. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone.number.type` | String | N/A | Read-only | Type of the phone number, such as `standard` or `mobile`. | | `creditBureau.subject.` `subjectRecord.indicative.` `phone.source` | String | N/A | Read-only | Source of the phone number, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity` | Object\[] | N/A | Read-only | Array of Social Security number (SSN) objects, which shows SSNs from various sources. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.ageObtained.rangeEnd` | String | N/A | Read-only | Oldest age of the range when the identification was issued. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.ageObtained.rangeStart` | String | N/A | Read-only | Youngest age of the range when the identification was issued. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.state` | String | N/A | Read-only | State in which the identification was issued. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.status` | String | N/A | Read-only | Status of the identification, such as `clear` or `issuedAfter21`. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.type` | String | N/A | Read-only | Type of identification: `ssn`. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.yearRange.endYear` | String | N/A | Read-only | Ending year of the range when the identification was issued. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.` `identificationIssuance.yearRange.startYear` | String | N/A | Read-only | Starting year of the range when the identification was issued. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.masked` | Boolean | N/A | Read-only | Whether or not the `number` is masked (digits hidden). | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.number` | String | N/A | Read-only | Social Security number. | | `creditBureau.subject.` `subjectRecord.indicative.` `socialSecurity.source` | String | N/A | Read-only | Source of the data shown, such as `input` (provided in the request), `file` (credit file), or `vendorFile` (non-credit file). |