--- title: "Query using demographic information (demographicsQuery)" method: POST path: "/demographicsQuery" --- # Query using demographic information (demographicsQuery) `POST /demographicsQuery` Searches Verato using the provided demographic information and returns the best-matching identity if found. ## Request body - ServiceRequestDemographicsQuery - `content` DemographicsQueryWsRequest — Request object for demographics query. - `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. - `responseIdentityFormatNames` string[] — Response identity formats. DEFAULT if omitted. - `trackingId` string ## Response `200` Successful demographics query operation. - ServiceResponseDemographicsQuery - `auditId` string - `success` boolean - `warnings` string[] - `retryableError` boolean - `message` string - `content` DemographicsQueryWsResponse — Response object for demographics query. - `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. - `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 - `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. - `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)