# Query using LINK ID Queries the LINK database for an identity using the Verato LINK ID. This is the primary way to retrieve an identity when you already have the linkId from a previous operation. Endpoint: POST /identityIdQuery Version: 2026.1.2 Security: bearerAuth ## Request fields (application/json): - `auditId` (string) Unique audit identifier for correlating requests and responses. - `auditLogMap` (object) Map of string keys to string values. - `trackingId` (string) Optional client-defined correlation ID. - `content` (object) Query by linkId. - `content.linkId` (string, required) - `content.responseIdentityFormatNames` (array) ## Response 200 fields (application/json): - `auditId` (string) Unique audit identifier for correlating requests and responses. - `success` (boolean) Indicates whether the business operation succeeded. - `unparsedJson` (string) Raw response payload, for debugging or migration. - `warnings` (array) Non-fatal warnings generated by the operation. - `retryableError` (boolean) Indicates whether an error is transient and the request may be retried. - `message` (string) Human-readable status message. - `errors` (array) Error messages if success is false. - `trackingId` (string) Echo of the request trackingId, if provided. - `content` (object) Identity-by-linkId response content. - `content.identityGroupedBySource` (array) - `content.identityGroupedBySource.source` (object) Tracks an identity back to its source system. - `content.identityGroupedBySource.source.date` (string) - `content.identityGroupedBySource.source.name` (string) Unique source system name across Verato. - `content.identityGroupedBySource.source.id` (string) Native ID of the identity within the source. - `content.identityGroupedBySource.addresses` (array) - `content.identityGroupedBySource.addresses.addressName` (string) - `content.identityGroupedBySource.addresses.addressType` (string) - `content.identityGroupedBySource.addresses.line1` (string) - `content.identityGroupedBySource.addresses.line2` (string) - `content.identityGroupedBySource.addresses.city` (string) - `content.identityGroupedBySource.addresses.district` (string) - `content.identityGroupedBySource.addresses.state` (string) - `content.identityGroupedBySource.addresses.postalCode` (string) - `content.identityGroupedBySource.addresses.country` (string) - `content.identityGroupedBySource.addresses.latitude` (number) - `content.identityGroupedBySource.addresses.longitude` (number) - `content.identityGroupedBySource.addresses.validFrom` (string) - `content.identityGroupedBySource.addresses.validTo` (string) - `content.identityGroupedBySource.names` (array) - `content.identityGroupedBySource.names.use` (string) Name usage code (e.g., official, nickname). - `content.identityGroupedBySource.names.prefix` (string) - `content.identityGroupedBySource.names.first` (string) - `content.identityGroupedBySource.names.middle` (string) - `content.identityGroupedBySource.names.last` (string) - `content.identityGroupedBySource.names.suffix` (string) - `content.identityGroupedBySource.names.credential` (string) - `content.identityGroupedBySource.phoneNumbers` (array) - `content.identityGroupedBySource.phoneNumbers.number` (string) Phone number including country code and extension. - `content.identityGroupedBySource.phoneNumbers.type` (string) - `content.identityGroupedBySource.faxNumbers` (array) - `content.identityGroupedBySource.faxNumbers.number` (string) - `content.identityGroupedBySource.emails` (array) - `content.identityGroupedBySource.emails.email` (string) - `content.identityGroupedBySource.licenses` (array) - `content.identityGroupedBySource.licenses.taxonomyCode` (string) - `content.identityGroupedBySource.licenses.licenseEffectiveDate` (string) - `content.identityGroupedBySource.licenses.licenseExpirationDate` (string) - `content.identityGroupedBySource.licenses.licenseStatus` (string) - `content.identityGroupedBySource.licenses.licenseStatusDetail` (string) - `content.identityGroupedBySource.licenses.licenseProfessionCode` (string) - `content.identityGroupedBySource.licenses.licenseProfessionRankCode` (string) - `content.identityGroupedBySource.licenses.licenseLastUpdateDate` (string) - `content.identityGroupedBySource.licenses.licenseProfessionDescription` (string) - `content.identityGroupedBySource.licenses.licenseType` (string) - `content.identityGroupedBySource.licenses.licensePrimary` (string) - `content.identityGroupedBySource.specialties` (array) - `content.identityGroupedBySource.specialties.specialtyTaxonomyCode` (string) - `content.identityGroupedBySource.nPIs` (array) - `content.identityGroupedBySource.nPIs.npi` (string) - `content.identityGroupedBySource.nPIs.entityTypeCode` (string) - `content.identityGroupedBySource.nPIs.deactivationDate` (string) - `content.identityGroupedBySource.medicareInfo` (array) - `content.identityGroupedBySource.medicareInfo.inPecos` (boolean) - `content.identityGroupedBySource.medicareInfo.acceptsMedicare` (boolean) - `content.identityGroupedBySource.disciplinaryInfo` (array) - `content.identityGroupedBySource.disciplinaryInfo.warning` (boolean) - `content.identityGroupedBySource.disciplinaryInfo.exclusionType` (string) - `content.identityGroupedBySource.practiceInfo` (array) - `content.identityGroupedBySource.practiceInfo.estimatedPracticeYears` (integer) - `content.identityGroupedBySource.locationInfo` (array) - `content.identityGroupedBySource.locationInfo.ruralUrbanSuburban` (string) - `content.identityGroupedBySource.locationInfo.coloCode` (string) - `content.identityGroupedBySource.groupTaxonomies` (array) - `content.identityGroupedBySource.groupTaxonomies.groupTaxonomyCode` (string) - `content.identityGroupedBySource.organizationNames` (array) - `content.identityGroupedBySource.organizationNames.legalBusinessName` (string) - `content.identityGroupedBySource.organizationNames.otherOrgName` (string) - `content.identityGroupedBySource.organizationNames.tradingName` (string) - `content.identityGroupedBySource.organizationNames.parentOrgName` (string) - `content.identityGroupedBySource.authorizedOfficials` (array) - `content.identityGroupedBySource.authorizedOfficials.title` (string) - `content.identityGroupedBySource.authorizedOfficials.phoneNumber` (string) - `content.identityGroupedBySource.mergedSourceRecord` (object) Retired source record enriched with linkage metadata. - `content.identityGroupedBySource.mergedSourceRecord.name` (string) - `content.identityGroupedBySource.mergedSourceRecord.id` (string) - `content.identityGroupedBySource.mergedSourceRecord.activeNativeId` (string) - `content.identityGroupedBySource.mergedSourceRecord.activeSource` (string) - `content.identityGroupedBySource.mergedSourceRecord.timestamp` (string) Merge timestamp (UTC, ISO_LOCAL_DATE_TIME). - `content.identityGroupedBySource.softDeletedSourceRecord` (object) Tracks an identity back to its source system. - `content.customerSources` (array) - `content.linkId` (string) The linkId of the returned identity (may differ from requested). - `content.identity` (object) Unified identity representation. Only one of the following may be populated for a given instance: - Practitioner (Type 1) - Health Facility (Type 2) - `content.identity.Practitioner (Type 1)` (object) Practitioner (Type 1) – individual healthcare provider domain. - `content.identity.Practitioner (Type 1).datesOfBirth` (array) - `content.identity.Practitioner (Type 1).datesOfBirth.dateOfBirth` (string) - `content.identity.Practitioner (Type 1).genders` (array) - `content.identity.Practitioner (Type 1).genders.gender` (string) Administrative gender code. - `content.identity.Practitioner (Type 1).genderIdentities` (array) - `content.identity.Practitioner (Type 1).genderIdentities.genderIdentity` (string) Self-identified gender code. - `content.identity.Practitioner (Type 1).contactInformation` (array) - `content.identity.Practitioner (Type 1).contactInformation.address` (object) Standalone address representation. - `content.identity.Practitioner (Type 1).contactInformation.phoneList` (array) - `content.identity.Practitioner (Type 1).contactInformation.faxList` (array) - `content.identity.Practitioner (Type 1).contactInformation.bestTimeToContact` (array) - `content.identity.Practitioner (Type 1).contactInformation.bestTimeToContact.day` (string) Day-of-week code. - `content.identity.Practitioner (Type 1).contactInformation.bestTimeToContact.startTime` (string) - `content.identity.Practitioner (Type 1).contactInformation.bestTimeToContact.endTime` (string) - `content.identity.Practitioner (Type 1).contactInformation.bestTimeToContact.allDay` (boolean) - `content.identity.Practitioner (Type 1).npis` (array) - `content.identity.Practitioner (Type 1).license` (array) - `content.identity.Practitioner (Type 1).communicationLanguages` (array) - `content.identity.Practitioner (Type 1).communicationLanguages.language` (string) - `content.identity.Practitioner (Type 1).communicationLanguages.preferred` (boolean) - `content.identity.Practitioner (Type 1).practitionerRoles` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptingNewPatients` (boolean) - `content.identity.Practitioner (Type 1).practitionerRoles.serviceMode` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.clinicalExpertise` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.clinicalExpertise.url` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.program` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.specialty` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.specialty.isPrimary` (boolean) - `content.identity.Practitioner (Type 1).practitionerRoles.subSpecialty` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.subSpecialty.code` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.subSpecialty.status` (boolean) - `content.identity.Practitioner (Type 1).practitionerRoles.availability` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.availability.day` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances` (array) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.payerName` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.insuranceType` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.planId` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.planType` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.networkStatus` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.startDate` (string) - `content.identity.Practitioner (Type 1).practitionerRoles.acceptedInsurances.endDate` (string) - `content.identity.Practitioner (Type 1).qualifications` (array) - `content.identity.Practitioner (Type 1).qualifications.qualification` (string) - `content.identity.Practitioner (Type 1).qualifications.issuer` (string) - `content.identity.Practitioner (Type 1).qualifications.issueDate` (string) - `content.identity.Practitioner (Type 1).alternateIdentifiers` (array) - `content.identity.Practitioner (Type 1).alternateIdentifiers.description` (string) - `content.identity.Practitioner (Type 1).alternateIdentifiers.value` (string) - `content.identity.Practitioner (Type 1).externalUniqueIdentifier` (array) - `content.identity.Practitioner (Type 1).multipleBirthIndicator` (array) - `content.identity.Practitioner (Type 1).multipleBirthIndicator.multipleBirthInteger` (integer) - `content.identity.Practitioner (Type 1).multipleBirthIndicator.birthPlurality` (integer) - `content.identity.Practitioner (Type 1).ssns` (array) - `content.identity.Practitioner (Type 1).ssns.ssn` (string) - `content.identity.Practitioner (Type 1).citizenships` (array) - `content.identity.Practitioner (Type 1).citizenships.citizenship` (string) - `content.identity.Practitioner (Type 1).photos` (array) - `content.identity.Practitioner (Type 1).sexualOrientations` (array) - `content.identity.Practitioner (Type 1).sexualOrientations.sexualOrientation` (string) - `content.identity.Practitioner (Type 1).races` (array) - `content.identity.Practitioner (Type 1).races.race` (string) - `content.identity.Practitioner (Type 1).ethnicities` (array) - `content.identity.Practitioner (Type 1).ethnicities.ethnicity` (string) - `content.identity.Practitioner (Type 1).religiousAffiliations` (array) - `content.identity.Practitioner (Type 1).religiousAffiliations.religiousAffiliation` (string) - `content.identity.Practitioner (Type 1).maritalStatuses` (array) - `content.identity.Practitioner (Type 1).maritalStatuses.maritalStatus` (string) - `content.identity.Practitioner (Type 1).deathDetails` (array) - `content.identity.Practitioner (Type 1).deathDetails.deceased` (string) - `content.identity.Practitioner (Type 1).deathDetails.dateOfDeath` (string) - `content.identity.Practitioner (Type 1).deathDetails.county` (string) - `content.identity.Practitioner (Type 1).consents` (array) - `content.identity.Practitioner (Type 1).consents.isRequired` (boolean) - `content.identity.Practitioner (Type 1).consents.decision` (string) - `content.identity.Practitioner (Type 1).consents.source` (string) - `content.identity.Practitioner (Type 1).consents.regulatoryBasis` (string) - `content.identity.Practitioner (Type 1).preferences` (array) - `content.identity.Practitioner (Type 1).preferences.channels` (array) - `content.identity.Practitioner (Type 1).preferences.channels.isOptedIn` (boolean) - `content.identity.Practitioner (Type 1).preferences.channels.lastOptedInDate` (string) - `content.identity.Practitioner (Type 1).preferences.channels.frequency` (string) - `content.identity.Practitioner (Type 1).preferences.channels.preferredStartTime` (string) - `content.identity.Practitioner (Type 1).preferences.channels.preferredEndTime` (string) - `content.identity.Practitioner (Type 1).education` (array) - `content.identity.Practitioner (Type 1).education.medSchool` (string) - `content.identity.Practitioner (Type 1).education.gradYear` (integer) - `content.identity.Practitioner (Type 1).research` (array) - `content.identity.Practitioner (Type 1).research.areasOfInterest` (string) - `content.identity.Practitioner (Type 1).research.publications` (string) - `content.identity.Health Facility (Type 2)` (object) Health Facility (Type 2) – organizational healthcare provider domain. - `content.identity.Health Facility (Type 2).employerIdentificationNumber` (array) - `content.identity.Health Facility (Type 2).naicsClassifications` (array) - `content.identity.Health Facility (Type 2).naicsClassifications.sector` (string) - `content.identity.Health Facility (Type 2).naicsClassifications.subSector` (string) - `content.identity.Health Facility (Type 2).naicsClassifications.industryGroup` (string) - `content.identity.Health Facility (Type 2).naicsClassifications.industry` (string) - `content.identity.Health Facility (Type 2).naicsClassifications.nationalIndustry` (string) - `content.identity.Health Facility (Type 2).sicClassifications` (array) - `content.identity.Health Facility (Type 2).types` (array) - `content.identity.Health Facility (Type 2).types.subType` (string) - `content.identity.Health Facility (Type 2).contactOther` (array) - `content.identity.Health Facility (Type 2).contactOther.system` (string) - `content.identity.Health Facility (Type 2).product` (array) - `content.identity.Health Facility (Type 2).product.category` (string) - `content.identity.Health Facility (Type 2).product.price` (number) - `content.identity.Health Facility (Type 2).product.launchDate` (string) - `content.identity.Health Facility (Type 2).product.market` (string) - `content.identity.Health Facility (Type 2).product.lineOfBusiness` (string) - `content.identity.Health Facility (Type 2).product.serviceLines` (array) - `content.identity.Health Facility (Type 2).product.serviceLines.serviceLine` (string) - `content.identity.Health Facility (Type 2).product.serviceLines.subServiceLine` (string) - `content.identity.Health Facility (Type 2).numberOfEmployees` (array) - `content.identity.Health Facility (Type 2).foundedDate` (array) - `content.identity.Health Facility (Type 2).annualRevenue` (array) - `content.identity.Health Facility (Type 2).annualRevenue.year` (integer) - `content.identity.Health Facility (Type 2).legalStatus` (array) - `content.identity.Health Facility (Type 2).legalStatus.effectiveDate` (string) - `content.identity.Health Facility (Type 2).legalStatus.verificationDate` (string) - `content.identity.Health Facility (Type 2).legalStatus.jurisdiction` (string) - `content.identity.Health Facility (Type 2).legalStatus.registrationCountry` (string) - `content.domains` (array) - `content.domains.id` (string) Domain identifier. - `content.domains.name` (string) Domain name. - `content.requestedLinkId` (string) - `content.customizedIdentities` (object) Map of string keys to arbitrary JSON values.