linkIdLookupBySourceRecords

The linkIdLookupBySourceRecords web service accepts a list of Source + Native ID (S+N) and returns a list of all Link IDs that contains any of those S+N records along with its associated records and source metadata.

This helps Verato MDM Cloud’s downstream services (e.g., Tasks, Entity-360 Views) quickly determine which LinkIDs are associated with known S+N pairs while limiting latency.

Sample URL

The URL for this request is of the format https://custXXXX.verato-connect.com/provider-link-ws/svc/linkIdLookupBySourceRecords , where XXXX is a 4-digit number.

linkIdLookupBySourceRecords JSON request

• The request consists of primarily:
  • Source+Native ID – a Source+Native ID combination that represents a source record previously posted to Verato.

• {
    "trackingId": "string",
    "content": {
      "records": [
        {
          "source": "string",
          "nativeId": "string"
        }
      ]
    }
  }

linkIdLookupBySourceRecords 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
  • Results divided into objects containing the following:
    • The Link ID associated with the source record requested in the query
    • The source, nativeId, display name, and match tier of the source records associated with that Link ID

• {
    "success": true,
    "message": "Identities found!",
    "content": {
      "results": [
        {
          "linkId": "string",
          "records": [
            {
              "source": {
                "name": "string",
                "displayName": "string",
                "tier": integer
              },
              "nativeId": "string"
            }
          ]
        }
      ]
    },
    "trackingId": "string",
    "auditId": "string",
    "retryableError": false,
    "warnings": []
  }