List Interactions associated with a Profile Type (Hub Data)

[This topic is pre-release documentation and is subject to change.]

Lists all Interaction instances that form an association to or from the specified Profile type.


The request is constructed as follows:

HTTP Verb Request URI
GET <hub-endpoint>/data/Contacts('<contactid>')/Interactions?api-version=2017-04-26

URI Parameters

URI Parameter Required Description
Hub-endpoint Yes The base URL for your Customer Insights Hub.
contactId Yes The ID of the custom entity type

Complex filter expressions can be applied to this operation as demonstrated in the following request.

GET <hub-endpoint>/data/Contacts('contactId')/Interactions?api-version=2017-04-26&$filter=Timestamp gt 
      cast('2013-06-26T03:30:00.000Z', Edm.DateTimeOffset) and 
      Timestamp lt cast('2014-06-26T03:30:00.000Z', Edm.DateTimeOffset)

Predictive Matching

Profile-to-interaction matching enables the retrieval of matched interactions through the use of the includePredictiveMatchResults flag. Furthermore, results can be narrowed only to predictive matched interactions through the use of the appropriate filter, for example:

GET <hub-endpoint>/data/contacts('<contactId>')/interactions?includePredictiveMatchResults=true&$filter='type=conflation'&api-version=2017-04-26


The response includes an HTTP status code, a response body and a set of response headers.

Results are returned as a set of pages. The existence of the server-side paging token (OData $skiptoken) enables the retrieval of the next page of results. The results are ordered by modification timestamp, with the most recently changed entities appearing first.

Response Body

A collection of custom Interaction instances.

Status Code

  • 200 (OK) - the request succeeded.