# Search using demographic information Searches the LINK database using the provided demographic information and returns zero or more candidate identities ordered by match score. Endpoint: POST /demographicsSearch Version: 2026.1.2 Security: bearerAuth ## Request fields (application/json): - `auditId` (string) Audit identifier used for tracing and governance across Verato services. - `auditLogMap` (object) Generic map of string keys to string values. - `content` (object) Request object for demographics search. - `content.identity` (object, required) Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `content.identity.organizationNames` (array) - `content.identity.organizationNames.legalBusinessName` (string) TEXT data type, see documentation for more details. - `content.identity.organizationNames.otherOrgName` (string) TEXT data type, see documentation for more details. - `content.identity.organizationNames.tradingName` (string) TEXT data type, see documentation for more details. - `content.identity.organizationNames.parentOrgName` (string) TEXT data type, see documentation for more details. - `content.identity.addresses` (array) - `content.identity.addresses.addressName` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.addressType` (string) CODE-SET data type, see documentation for more details. - `content.identity.addresses.line1` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.line2` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.city` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.district` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.state` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.postalCode` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.country` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.latitude` (string) NUMBER data type, see documentation for more details. - `content.identity.addresses.longitude` (string) NUMBER data type, see documentation for more details. - `content.identity.addresses.validFrom` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.addresses.validTo` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.contactInformation` (array) Example: [{"address":{"line1":"123 Main St","city":"Springfield","state":"VA","postalCode":"22150"},"phoneList":[{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}],"bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.identity.contactInformation.address` (object) - `content.identity.contactInformation.phoneList` (array) Example: [{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.identity.contactInformation.phoneList.number` (string) NUMBER data type, see documentation for more details. - `content.identity.contactInformation.phoneList.type` (string) CODE-SET data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact` (object) - `content.identity.contactInformation.phoneList.bestTimeToContact.day` (string) CODE-SET data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact.startTime` (string) TIME data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact.endTime` (string) TIME data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact.allDay` (boolean) BOOLEAN data type, see documentation for more details. - `content.identity.contactInformation.faxList` (array) - `content.identity.contactInformation.faxList.number` (string) TEXT data type, see documentation for more details. - `content.identity.phoneNumbers` (array) Example: [{"number":"5551234567","type":"WORK","validFrom":"2024-01-01","validTo":"2024-12-31","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.identity.faxNumbers` (array) - `content.identity.emails` (array) - `content.identity.emails.email` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers` (array) - `content.identity.alternateIdentifiers.description` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers.value` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers.status` (boolean) BOOLEAN data type, see documentation for more details. - `content.identity.alternateIdentifiers.issuer` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers.issueDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.alternateIdentifiers.startDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.alternateIdentifiers.endDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.externalUniqueIdentifier` (array) - `content.identity.externalUniqueIdentifier.status` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials` (array) - `content.identity.authorizedOfficials.title` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.prefix` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.first` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.middle` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.last` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.suffix` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.credential` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.phoneNumber` (string) TEXT data type, see documentation for more details. - `content.identity.employerIdentificationNumber` (array) - `content.identity.naicsClassifications` (array) - `content.identity.naicsClassifications.sector` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.subSector` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.industryGroup` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.industry` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.nationalIndustry` (string) CODE-SET data type, see documentation for more details. - `content.identity.sicClassifications` (array) - `content.identity.sicClassifications.code` (string) CODE-SET data type, see documentation for more details. - `content.identity.qualifications` (array) - `content.identity.qualifications.qualification` (string) TEXT data type, see documentation for more details. - `content.identity.qualifications.status` (string) CODE-SET data type, see documentation for more details. - `content.identity.types` (array) - `content.identity.types.type` (string) TEXT data type, see documentation for more details. - `content.identity.types.subType` (string) TEXT data type, see documentation for more details. - `content.identity.contactOther` (array) - `content.identity.contactOther.system` (string) CODE-SET data type, see documentation for more details. - `content.identity.product` (array) - `content.identity.product.name` (string) TEXT data type, see documentation for more details. - `content.identity.product.code` (string) TEXT data type, see documentation for more details. - `content.identity.product.category` (string) TEXT data type, see documentation for more details. - `content.identity.product.price` (string) NUMBER data type, see documentation for more details. - `content.identity.product.launchDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.product.market` (string) TEXT data type, see documentation for more details. - `content.identity.product.lineOfBusiness` (string) TEXT data type, see documentation for more details. - `content.identity.product.serviceLines` (array) - `content.identity.product.serviceLines.serviceLine` (string) TEXT data type, see documentation for more details. - `content.identity.product.serviceLines.subServiceLine` (string) TEXT data type, see documentation for more details. - `content.identity.numberOfEmployees` (array) - `content.identity.numberOfEmployees.numberOfEmployees` (string) NUMBER data type, see documentation for more details. - `content.identity.foundedDate` (array) - `content.identity.foundedDate.foundedDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.annualRevenue` (array) - `content.identity.annualRevenue.annualRevenue` (string) NUMBER data type, see documentation for more details. - `content.identity.annualRevenue.year` (string) NUMBER data type, see documentation for more details. - `content.identity.legalStatus` (array) - `content.identity.legalStatus.source` (string) TEXT data type, see documentation for more details. - `content.identity.legalStatus.effectiveDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.legalStatus.verificationDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.legalStatus.jurisdiction` (string) TEXT data type, see documentation for more details. - `content.identity.legalStatus.registrationCountry` (string) CODE-SET data type, see documentation for more details. - `content.matchScoreThreshold` (number) Only identities with match scores >= this value appear in the response. - `content.maxSearchResults` (integer) Number of results to return. Must be greater than 0. - `content.responseIdentityFormatNames` (array) Response identity view names. If omitted, DEFAULT is assumed. - `trackingId` (string) ## Response 200 fields (application/json): - `auditId` (string) Audit identifier used for tracing and governance across Verato services. - `success` (boolean) - `unparsedJson` (string) - `warnings` (array) - `retryableError` (boolean) - `message` (string) - `content` (object) Response object for demographics search. - `content.searchResults` (array, required) Search results ordered from best to worst match. Empty if no matches. - `content.searchResults.identityGroupedBySource` (array) - `content.searchResults.identityGroupedBySource.source` (object) Tracks an identity to a particular source system and record ID. - `content.searchResults.identityGroupedBySource.source.date` (string) The date of the source data in ISO format (yyyy-MM-dd). - `content.searchResults.identityGroupedBySource.source.name` (string) Name of the data source. Must be unique across Verato. - `content.searchResults.identityGroupedBySource.source.id` (string) ID of an identity within the given data source. - `content.searchResults.matchScore` (number, required) Match score between 0.0 and 1.0. - `content.searchResults.customerSources` (array) - `content.searchResults.linkId` (string) LINK ID of the returned identity, if any. - `content.searchResults.identity` (object) Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `content.searchResults.identity.organizationNames` (array) - `content.searchResults.identity.organizationNames.legalBusinessName` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.organizationNames.otherOrgName` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.organizationNames.tradingName` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.organizationNames.parentOrgName` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses` (array) - `content.searchResults.identity.addresses.addressName` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.addressType` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.addresses.line1` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.line2` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.city` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.district` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.state` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.postalCode` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.country` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.addresses.latitude` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.addresses.longitude` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.addresses.validFrom` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.addresses.validTo` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.contactInformation` (array) Example: [{"address":{"line1":"123 Main St","city":"Springfield","state":"VA","postalCode":"22150"},"phoneList":[{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}],"bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.searchResults.identity.contactInformation.address` (object) - `content.searchResults.identity.contactInformation.phoneList` (array) Example: [{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.searchResults.identity.contactInformation.phoneList.number` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.contactInformation.phoneList.type` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.contactInformation.phoneList.bestTimeToContact` (object) - `content.searchResults.identity.contactInformation.phoneList.bestTimeToContact.day` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.contactInformation.phoneList.bestTimeToContact.startTime` (string) TIME data type, see documentation for more details. - `content.searchResults.identity.contactInformation.phoneList.bestTimeToContact.endTime` (string) TIME data type, see documentation for more details. - `content.searchResults.identity.contactInformation.phoneList.bestTimeToContact.allDay` (boolean) BOOLEAN data type, see documentation for more details. - `content.searchResults.identity.contactInformation.faxList` (array) - `content.searchResults.identity.contactInformation.faxList.number` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.phoneNumbers` (array) Example: [{"number":"5551234567","type":"WORK","validFrom":"2024-01-01","validTo":"2024-12-31","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.searchResults.identity.faxNumbers` (array) - `content.searchResults.identity.emails` (array) - `content.searchResults.identity.emails.email` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.alternateIdentifiers` (array) - `content.searchResults.identity.alternateIdentifiers.description` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.alternateIdentifiers.value` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.alternateIdentifiers.status` (boolean) BOOLEAN data type, see documentation for more details. - `content.searchResults.identity.alternateIdentifiers.issuer` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.alternateIdentifiers.issueDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.alternateIdentifiers.startDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.alternateIdentifiers.endDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.externalUniqueIdentifier` (array) - `content.searchResults.identity.externalUniqueIdentifier.status` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials` (array) - `content.searchResults.identity.authorizedOfficials.title` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.prefix` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.first` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.middle` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.last` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.suffix` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.credential` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.authorizedOfficials.phoneNumber` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.employerIdentificationNumber` (array) - `content.searchResults.identity.naicsClassifications` (array) - `content.searchResults.identity.naicsClassifications.sector` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.naicsClassifications.subSector` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.naicsClassifications.industryGroup` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.naicsClassifications.industry` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.naicsClassifications.nationalIndustry` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.sicClassifications` (array) - `content.searchResults.identity.sicClassifications.code` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.qualifications` (array) - `content.searchResults.identity.qualifications.qualification` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.qualifications.status` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.types` (array) - `content.searchResults.identity.types.type` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.types.subType` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.contactOther` (array) - `content.searchResults.identity.contactOther.system` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.identity.product` (array) - `content.searchResults.identity.product.name` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.product.code` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.product.category` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.product.price` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.product.launchDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.product.market` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.product.lineOfBusiness` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.product.serviceLines` (array) - `content.searchResults.identity.product.serviceLines.serviceLine` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.product.serviceLines.subServiceLine` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.numberOfEmployees` (array) - `content.searchResults.identity.numberOfEmployees.numberOfEmployees` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.foundedDate` (array) - `content.searchResults.identity.foundedDate.foundedDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.annualRevenue` (array) - `content.searchResults.identity.annualRevenue.annualRevenue` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.annualRevenue.year` (string) NUMBER data type, see documentation for more details. - `content.searchResults.identity.legalStatus` (array) - `content.searchResults.identity.legalStatus.source` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.legalStatus.effectiveDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.legalStatus.verificationDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.searchResults.identity.legalStatus.jurisdiction` (string) TEXT data type, see documentation for more details. - `content.searchResults.identity.legalStatus.registrationCountry` (string) CODE-SET data type, see documentation for more details. - `content.searchResults.sameIdentity` (string, required) Y/U/N indicator for same identity. - `content.searchResults.domains` (array) - `content.searchResults.domains.name` (string) - `content.searchResults.domains.id` (string) - `content.searchResults.customizedIdentities` (object) - `errors` (array) - `trackingId` (string)