searchRelationshipService

  • Web Services
  • API Documentation
  • Provider

An important component of Provider Data Management is the ability to understand and define how a given Provider (either an individual practitioner or an organization) relates to other Providers.

With Verato, a user can create direct relationships between Provider entities (mapped from LinkID to LinkID). Verato supplies pre-defined relationship types, sometimes referred to as “verbs”, to define the relationship that exists between two entities. Examples may include is employed by or is affiliated with. Customers can work with Verato customer support representatives to define additional relationship types on an as-needed basis. Relationship domains–for example Organization or Facility–are a way to group common relationship types together.

searchRelationshipService JSON request

  • The request includes:

    • A tracking ID (an optional identifier that the client can supply to track the response)
  • {{ 
      "trackingId": "string", 
      "content": { 
        "relationshipFilter": { 
          "filterBySubjectVeratoId": "string", 
          "filterBySubjectOrObjectVeratoId": "string", 
          "filterByObjectVeratoId": "string", 
          "filterByRelationshipVerb": "string" 
        } 
    } 

searchRelationshipService JSON response

  • 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
  • { 
        "success": boolean, 
        "message": "string", 
        "content": { 
            "relationships": [ 
                { 
                    "id": "string", 
                    "subjectVeratoId": "string", 
                    "objectVeratoId": "string", 
                    "domain": "string", 
                    "relationshipVerb": "string", 
                    "startDate": "string", 
                    "endDate": "string", 
                    "status": "string", 
                    "trustFactor": "string" 
                }        ] 
        }, 
        "trackingId": "string", 
        "auditId": "string", 
        "retryableError": boolean 
    }