The identityIdQuery service retrieves a single matching identity from Provider Data Management based on the Link ID for the identity.
Like the postIdentity web service, the query web services allow the client to provide a “tracking ID” string that is client-generated, which is echoed back in the web service response. This provides the ability to track specific web service requests/responses using a message identifier that is meaningful to the client. In addition to the “tracking ID” in the web service request, the content of the query request will vary across the three different query web services.
*For customers with the Address Verification Service, please see the guide for additional data and API response information.
Sample URL
The URL for this request is of the format https://custXXXX-provider.verato-connect.com/provider-link-ws/svc/identityIdQuery, where XXXX is a 4-digit number.
identityIdQuery JSON request
-
The identityIdQuery consists of a Link ID value. If this Link ID value is assigned to an identity in Universal Identity, the identity is returned. In addition, all web service query requests can also include an optional string indicating which format to use in grouping Identity information in the web service response:
- DEFAULT -- Groups identity information into a single Identity object
- GROUP_BY_SOURCE -- Groups identity information into one object for each source record (Source + Native ID)
-
{ "trackingId": "string", "content": { "responseIdentityFormatNames": ["string"], "linkId": "string" } }
identityIdQuery JSON response
-
If the DEFAULT identity response format is requested or no response was specified, the JSON object for the body includes:
- An ‘echo’ of the same tracking ID from the request
- Several Boolean and string values with more information about the success/failure of the service
- The Link ID of the identity returned from the query
- An identity object consisting of both of the following:
- The list of Source+Native ID values that are associated with the Link ID
- The demographic attribute data for the overall Provider Data Management identity (which may include attribute data from multiple source records matched together into this single Link ID). The format of this identity object will vary depending on which format was requested in the web service request JSON.
-
{ "success": boolean, "message": "string”, "content": { "linkId": "string", "identity": { "linkId": "string", "sources": [ { "name": "string", "id": "string" } ], "mergedSourceRecords": [], "names": [ { "first": "string", "middle": "string", "last": "string", "suffix": "string", "prefix": "string", "credential": "string" } ], "authorizedOfficials": [ { "title": "string", "phoneNumber": "string", "namePrefix": "string", "firstName": "string", "middleName": "string", "lastName": "string", "nameSuffix": "string", "nameCredential": "string" } ], "npis": [ { "npi": "string", "entityTypeCode": "string" } ], "license": [ { "number": "string", "state": "string", "taxonomyCode": "string", "licenseEffectiveDate": "string", "licenseExpirationDate": "string", "licenseStatus": "string", "licenseProfessionCode": "string", "licenseProfessionRankCode": "string", "licenseLastUpdateDate": "string", "licenseGrouping": "string", "licenseClassification": "string", "licenseSpecialization": "string" } ], "contactInformation": [ { "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "postalCode": "string", "addressType": "string", "addressName": "string" }, "phoneList": [ { "number": "string", "type": "string" } ], "faxList": [ { "number": "string", "type": "string" } ] } ], "specialties": [ { "specialtyTaxonomyCode": "string", "grouping": "string", "classification": "string", "specialization": "string" } ], "addresses": [ { "line1": "string", "line2": "string", "city": "string", "state": "string", "postalCode": "string" ], "genders": [ "string" ], "emails": [ "string" ], "phoneNumbers": [ { "number": "string", "type": "string" } ], "faxNumbers": [ { "type": "string", "number": "string" } ], "disciplinaryInfo": [ { "warning": "string", "exclusionType": "string" } ], "groupTaxonomies": [ { "groupTaxonomyCode": "string" } ], "medicareInfo": [ { "inPecos": "string", "acceptsMedicare": "string" } ], "education": [ { "medSchool": "string", "gradYear": "string" } ], "locationInfo": [ { "ruralUrbanSuburban": "string", "coloCode": "string" } ], "practiceInfo": [ { "estimatedPracticeYears": "string" } ], "unmergeable": [], "organizationNames": [ { "legalBusinessName": "string", "parentOrgName": "string" } ] } }, "trackingId": "string", "auditId": UUID, "retryableError": boolean -
{ "success": "string", "message": "string", "content": { "linkId": "string", "identityGroupedBySource": [ { "source": { "name": "string", "id": "string" }, "names": [ { "firstAsserted": "string", "lastAsserted": "string", "name": { "first": "string", "middle": "string", "last": "string", "suffix": "string", "prefix": "string", "credential": "string" } } ], "organizationNames": [ { "firstAsserted": "string", "lastAsserted": "string", "organization": { "legalBusinessName": "string", "otherOrgName": "string", "parentOrgName": "string" } } ], "npis": [ { "firstAsserted": "string", "lastAsserted": "string", "npiObject": { "npi": "string", "entityTypeCode": "string" } } ], "licenses": [ { "firstAsserted": "string", "lastAsserted": "string", "license": { "number": "string", "state": "string", "taxonomyCode": "string", "licenseEffectiveDate": "string", "licenseExpirationDate": "string", "licenseStatus": "string", "licenseProfessionCode": "string", "licenseProfessionRankCode": "string", "licenseLastUpdateDate": "string", "licenseGrouping": "string", "licenseClassification": "string", "licenseSpecialization": "string" } } ], "specialties": [ { "firstAsserted": "string", "lastAsserted": "string", "specialty": { "specialtyTaxonomyCode": "string", "grouping": "string", "classification": "string", "specialization": "string" } } ], "contactInformation": [ { "firstAsserted": "string", "lastAsserted": "string", "contactInformation": { "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "postalCode": "string", "addressType": "string", "addressName": "string" }, "phoneList": [ { "number": "string", "type": "string" } ], "faxList": [ { "type": "string", "number": "string" } ] } } ], "addresses": [ { "firstAsserted": "string", "lastAsserted": "string", "address": { "line1": "string", "line2": "string", "city": "string", "state": "string", "postalCode": "string" } }, "addressDetails": [], "genders": [ { "firstAsserted": "string", "lastAsserted": "string", "gender": "string" } ], "emails": [ { "firstAsserted": "string", "lastAsserted": "string", "email": "string" } ], "phoneNumbers": [ { "firstAsserted": "string", "lastAsserted": "string", "phoneNumber": { "number": "string", "type": "string" } } ], "faxNumbers": [ { "firstAsserted": "string", "lastAsserted": "string", "faxNumber": { "type": "string", "number": "string" } } ], "authorizedOfficials": [ { "firstAsserted": "string", "lastAsserted": "string", "authorizedOfficial": { "title": "string", "phoneNumber": "string", "namePrefix": "string", "firstName": "string", "middleName": "string", "lastName": "string", "nameSuffix": "string", "nameCredential": "string" } } ], "medicareInfo": [ { "firstAsserted": "string", "lastAsserted": "string", "medicareInfo": { "inPecos": "string", "acceptsMedicare": "string" } } ], "disciplinaryInfo": [ { "firstAsserted": "string", "lastAsserted": "string "disciplinaryInfo": { "warning": "string", "exclusionType": "string" } } ], "groupTaxonomies": [ { "firstAsserted": "string", "lastAsserted": "string", "groupTaxonomyCode": "string" } ], "education": [ { "firstAsserted": "string", "lastAsserted": "string", "education": { "medSchool": "string", "gradYear": "string" } } ], "locationInfo": [ { "firstAsserted": "string", "lastAsserted": "string", "locationInfo": { "ruralUrbanSuburban": "string", "coloCode": "string" } } ], "practiceInfo": [ { "firstAsserted": "string", "lastAsserted": "string", "practiceInfo": { "estimatedPracticeYears": "string" } } ] } ] }, "errors": "string", "trackingId": "string", "auditId": UUID, "retryableError": boolean }