--- title: "Search using demographic information (demographicsSearch)" method: POST path: "/demographicsSearch" --- # Search using demographic information (demographicsSearch) `POST /demographicsSearch` Searches Verato using the provided demographic and provider attributes. It returns zero or more candidate identities ordered by match score. ## Request body - ServiceRequestDemographicsSearch - `content` DemographicsSearchWsRequest — Request object for demographics search. - `identity` Identity, required — Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `organizationNames` OrganizationNames[] - `legalBusinessName` string — TEXT data type, see documentation for more details. - `otherOrgName` string — TEXT data type, see documentation for more details. - `tradingName` string — TEXT data type, see documentation for more details. - `parentOrgName` string — TEXT data type, see documentation for more details. - `addresses` Addresses[] - `addressName` string — TEXT data type, see documentation for more details. - `addressType` string — CODE-SET data type, see documentation for more details. - `line1` string — TEXT data type, see documentation for more details. - `line2` string — TEXT data type, see documentation for more details. - `city` string — TEXT data type, see documentation for more details. - `district` string — TEXT data type, see documentation for more details. - `state` string — TEXT data type, see documentation for more details. - `postalCode` string — TEXT data type, see documentation for more details. - `country` string — TEXT data type, see documentation for more details. - `latitude` string — NUMBER data type, see documentation for more details. - `longitude` string — NUMBER data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `contactInformation` ContactInformation[] - `address` Addresses - `addressName` string — TEXT data type, see documentation for more details. - `addressType` string — CODE-SET data type, see documentation for more details. - `line1` string — TEXT data type, see documentation for more details. - `line2` string — TEXT data type, see documentation for more details. - `city` string — TEXT data type, see documentation for more details. - `district` string — TEXT data type, see documentation for more details. - `state` string — TEXT data type, see documentation for more details. - `postalCode` string — TEXT data type, see documentation for more details. - `country` string — TEXT data type, see documentation for more details. - `latitude` string — NUMBER data type, see documentation for more details. - `longitude` string — NUMBER data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `phoneList` PhoneNumbers[] - `number` string — NUMBER data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `bestTimeToContact` BestTimeToContact - `day` string — CODE-SET data type, see documentation for more details. - `startTime` string — TIME data type, see documentation for more details. - `endTime` string — TIME data type, see documentation for more details. - `allDay` boolean — BOOLEAN data type, see documentation for more details. - `faxList` FaxNumbers[] - `number` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `bestTimeToContact` BestTimeToContact - `day` string — CODE-SET data type, see documentation for more details. - `startTime` string — TIME data type, see documentation for more details. - `endTime` string — TIME data type, see documentation for more details. - `allDay` boolean — BOOLEAN data type, see documentation for more details. - `phoneNumbers` PhoneNumbers[] - `number` string — NUMBER data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `bestTimeToContact` BestTimeToContact - `day` string — CODE-SET data type, see documentation for more details. - `startTime` string — TIME data type, see documentation for more details. - `endTime` string — TIME data type, see documentation for more details. - `allDay` boolean — BOOLEAN data type, see documentation for more details. - `faxNumbers` FaxNumbers[] - `number` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `emails` Emails[] - `email` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `alternateIdentifiers` AlternateIdentifiers[] - `description` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `value` string — TEXT data type, see documentation for more details. - `status` boolean — BOOLEAN data type, see documentation for more details. - `issuer` string — TEXT data type, see documentation for more details. - `issueDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `startDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `endDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `externalUniqueIdentifier` ExternalUniqueIdentifier[] - `issuer` string — TEXT data type, see documentation for more details. - `value` string — TEXT data type, see documentation for more details. - `status` string — TEXT data type, see documentation for more details. - `startDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `endDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `authorizedOfficials` AuthorizedOfficials[] - `title` string — TEXT data type, see documentation for more details. - `prefix` string — TEXT data type, see documentation for more details. - `first` string — TEXT data type, see documentation for more details. - `middle` string — TEXT data type, see documentation for more details. - `last` string — TEXT data type, see documentation for more details. - `suffix` string — TEXT data type, see documentation for more details. - `credential` string — TEXT data type, see documentation for more details. - `phoneNumber` string — TEXT data type, see documentation for more details. - `employerIdentificationNumber` EmployerIdentificationNumber[] - `value` string — TEXT data type, see documentation for more details. - `status` boolean — BOOLEAN data type, see documentation for more details. - `issuer` string — TEXT data type, see documentation for more details. - `issueDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `naicsClassifications` NaicsClassifications[] - `sector` string — CODE-SET data type, see documentation for more details. - `subSector` string — CODE-SET data type, see documentation for more details. - `industryGroup` string — CODE-SET data type, see documentation for more details. - `industry` string — CODE-SET data type, see documentation for more details. - `nationalIndustry` string — CODE-SET data type, see documentation for more details. - `sicClassifications` SicClassifications[] - `code` string — CODE-SET data type, see documentation for more details. - `qualifications` Qualifications[] - `type` string — CODE-SET data type, see documentation for more details. - `qualification` string — TEXT data type, see documentation for more details. - `status` string — CODE-SET data type, see documentation for more details. - `issuer` string — TEXT data type, see documentation for more details. - `issueDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `types` Types[] - `type` string — TEXT data type, see documentation for more details. - `subType` string — TEXT data type, see documentation for more details. - `contactOther` ContactOther[] - `system` string — CODE-SET data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `value` string — TEXT data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `product` Product[] - `name` string — TEXT data type, see documentation for more details. - `code` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `category` string — TEXT data type, see documentation for more details. - `price` string — NUMBER data type, see documentation for more details. - `status` string — TEXT data type, see documentation for more details. - `description` string — TEXT data type, see documentation for more details. - `launchDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `market` string — TEXT data type, see documentation for more details. - `lineOfBusiness` string — TEXT data type, see documentation for more details. - `serviceLines` object[] - `serviceLine` string — TEXT data type, see documentation for more details. - `subServiceLine` string — TEXT data type, see documentation for more details. - `numberOfEmployees` NumberOfEmployees[] - `numberOfEmployees` string — NUMBER data type, see documentation for more details. - `foundedDate` FoundedDate[] - `foundedDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `annualRevenue` AnnualRevenue[] - `annualRevenue` string — NUMBER data type, see documentation for more details. - `year` string — NUMBER data type, see documentation for more details. - `legalStatus` LegalStatus[] - `type` string — CODE-SET data type, see documentation for more details. - `source` string — TEXT data type, see documentation for more details. - `effectiveDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `verificationDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `jurisdiction` string — TEXT data type, see documentation for more details. - `registrationCountry` string — CODE-SET data type, see documentation for more details. - `matchScoreThreshold` number, double — Only identities with match scores >= this value appear in the response. - `maxSearchResults` integer — Number of results to return. Must be greater than 0. - `responseIdentityFormatNames` string[] — Response identity view names. If omitted, DEFAULT is assumed. - `trackingId` string ## Response `200` Successful demographics search operation. - ServiceResponseDemographicsSearch - `auditId` string - `success` boolean - `warnings` string[] - `retryableError` boolean - `message` string - `content` DemographicsSearchWsResponse — Response object for demographics search. - `searchResults` DemographicsSearchResult[], required — Search results ordered from best to worst match. Empty if no matches. - `identityGroupedBySource` IdentityPerSource[] - `source` Source — Tracks an identity to a particular source system and record ID. - `date` string — The date of the source data in ISO format (yyyy-MM-dd). - `name` string — Name of the data source. Must be unique across Verato. - `id` string — ID of an identity within the given data source. - `matchScore` number, double, required — Match score between 0.0 and 1.0. - `customerSources` string[] - `linkId` string — link ID of the returned identity, if any. - `identity` Identity — Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `organizationNames` OrganizationNames[] - `legalBusinessName` string — TEXT data type, see documentation for more details. - `otherOrgName` string — TEXT data type, see documentation for more details. - `tradingName` string — TEXT data type, see documentation for more details. - `parentOrgName` string — TEXT data type, see documentation for more details. - `addresses` Addresses[] - `addressName` string — TEXT data type, see documentation for more details. - `addressType` string — CODE-SET data type, see documentation for more details. - `line1` string — TEXT data type, see documentation for more details. - `line2` string — TEXT data type, see documentation for more details. - `city` string — TEXT data type, see documentation for more details. - `district` string — TEXT data type, see documentation for more details. - `state` string — TEXT data type, see documentation for more details. - `postalCode` string — TEXT data type, see documentation for more details. - `country` string — TEXT data type, see documentation for more details. - `latitude` string — NUMBER data type, see documentation for more details. - `longitude` string — NUMBER data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `contactInformation` ContactInformation[] - `address` Addresses - `addressName` string — TEXT data type, see documentation for more details. - `addressType` string — CODE-SET data type, see documentation for more details. - `line1` string — TEXT data type, see documentation for more details. - `line2` string — TEXT data type, see documentation for more details. - `city` string — TEXT data type, see documentation for more details. - `district` string — TEXT data type, see documentation for more details. - `state` string — TEXT data type, see documentation for more details. - `postalCode` string — TEXT data type, see documentation for more details. - `country` string — TEXT data type, see documentation for more details. - `latitude` string — NUMBER data type, see documentation for more details. - `longitude` string — NUMBER data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `phoneList` PhoneNumbers[] - `number` string — NUMBER data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `bestTimeToContact` BestTimeToContact - … - `faxList` FaxNumbers[] - `number` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `bestTimeToContact` BestTimeToContact - `day` string — CODE-SET data type, see documentation for more details. - `startTime` string — TIME data type, see documentation for more details. - `endTime` string — TIME data type, see documentation for more details. - `allDay` boolean — BOOLEAN data type, see documentation for more details. - `phoneNumbers` PhoneNumbers[] - `number` string — NUMBER data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `bestTimeToContact` BestTimeToContact - `day` string — CODE-SET data type, see documentation for more details. - `startTime` string — TIME data type, see documentation for more details. - `endTime` string — TIME data type, see documentation for more details. - `allDay` boolean — BOOLEAN data type, see documentation for more details. - `faxNumbers` FaxNumbers[] - `number` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `emails` Emails[] - `email` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `alternateIdentifiers` AlternateIdentifiers[] - `description` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `value` string — TEXT data type, see documentation for more details. - `status` boolean — BOOLEAN data type, see documentation for more details. - `issuer` string — TEXT data type, see documentation for more details. - `issueDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `startDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `endDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `externalUniqueIdentifier` ExternalUniqueIdentifier[] - `issuer` string — TEXT data type, see documentation for more details. - `value` string — TEXT data type, see documentation for more details. - `status` string — TEXT data type, see documentation for more details. - `startDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `endDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `authorizedOfficials` AuthorizedOfficials[] - `title` string — TEXT data type, see documentation for more details. - `prefix` string — TEXT data type, see documentation for more details. - `first` string — TEXT data type, see documentation for more details. - `middle` string — TEXT data type, see documentation for more details. - `last` string — TEXT data type, see documentation for more details. - `suffix` string — TEXT data type, see documentation for more details. - `credential` string — TEXT data type, see documentation for more details. - `phoneNumber` string — TEXT data type, see documentation for more details. - `employerIdentificationNumber` EmployerIdentificationNumber[] - `value` string — TEXT data type, see documentation for more details. - `status` boolean — BOOLEAN data type, see documentation for more details. - `issuer` string — TEXT data type, see documentation for more details. - `issueDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `naicsClassifications` NaicsClassifications[] - `sector` string — CODE-SET data type, see documentation for more details. - `subSector` string — CODE-SET data type, see documentation for more details. - `industryGroup` string — CODE-SET data type, see documentation for more details. - `industry` string — CODE-SET data type, see documentation for more details. - `nationalIndustry` string — CODE-SET data type, see documentation for more details. - `sicClassifications` SicClassifications[] - `code` string — CODE-SET data type, see documentation for more details. - `qualifications` Qualifications[] - `type` string — CODE-SET data type, see documentation for more details. - `qualification` string — TEXT data type, see documentation for more details. - `status` string — CODE-SET data type, see documentation for more details. - `issuer` string — TEXT data type, see documentation for more details. - `issueDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `types` Types[] - `type` string — TEXT data type, see documentation for more details. - `subType` string — TEXT data type, see documentation for more details. - `contactOther` ContactOther[] - `system` string — CODE-SET data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `value` string — TEXT data type, see documentation for more details. - `validFrom` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `validTo` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `product` Product[] - `name` string — TEXT data type, see documentation for more details. - `code` string — TEXT data type, see documentation for more details. - `type` string — CODE-SET data type, see documentation for more details. - `category` string — TEXT data type, see documentation for more details. - `price` string — NUMBER data type, see documentation for more details. - `status` string — TEXT data type, see documentation for more details. - `description` string — TEXT data type, see documentation for more details. - `launchDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `market` string — TEXT data type, see documentation for more details. - `lineOfBusiness` string — TEXT data type, see documentation for more details. - `serviceLines` object[] - `serviceLine` string — TEXT data type, see documentation for more details. - `subServiceLine` string — TEXT data type, see documentation for more details. - `numberOfEmployees` NumberOfEmployees[] - `numberOfEmployees` string — NUMBER data type, see documentation for more details. - `foundedDate` FoundedDate[] - `foundedDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `annualRevenue` AnnualRevenue[] - `annualRevenue` string — NUMBER data type, see documentation for more details. - `year` string — NUMBER data type, see documentation for more details. - `legalStatus` LegalStatus[] - `type` string — CODE-SET data type, see documentation for more details. - `source` string — TEXT data type, see documentation for more details. - `effectiveDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `verificationDate` string, date — DATE data type (yyyy-MM-dd), see documentation for more details. - `jurisdiction` string — TEXT data type, see documentation for more details. - `registrationCountry` string — CODE-SET data type, see documentation for more details. - `sameIdentity` string, required — Y/U/N indicator for same identity. - `domains` Domain[] - `name` string - `id` string - `customizedIdentities` object - `errors` string[] - `trackingId` string --- [API](https://skmtc.net/verato/apis/verato-organization-api.md) · [All operations](https://skmtc.net/verato/apis/verato-organization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verato/verato-organization-api/versions/9ebf5a50437d/schema)