nativeIdQuery

  • Web Services
  • API Documentation
  • Provider

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.

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: 

nativeIdQuerydemographicsQueryidentityQuery

  • 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   
    }