The nativeIdQuery web service retrieves the single matching identity from Provider Data Management that contains the Source+Native ID provided in the web service request.
Like the postIdentity web service, the query web services allow the client-generated tracking ID string, which is echoed back in the web service response. This allows you to track specific web service requests/responses using a customized message identifier relevant to your organization. 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/nativeIdQuery, where XXXX is a 4-digit number.
nativeIdQuery JSON request
-
The request consists of a Source+Native ID combination. If this Source+Native ID combination represents a customer record that was previously posted to Provider Data Management, that previously-posted identity will be returned.
-
{ "trackingId": "string", "content": { "responseIdentityFormatNames": ["string"], "source": { "name": "string", "id": "string" } } }
nativeID Query JSON response
Note
The web service response is the same for the following query web services:
The web service response is the same for the following query web services:
-
The response 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 (see section 3.1 above for more information)
- 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 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 }