Retrieve records for a contact from Insight data collection

get

https://{region}-api.dotdigital.com/insightData/v3/contacts/{identifier}/{value}/{collectionName}

Retrieves records from a specified Insight data collection for a contact

Note: All data is returned in ascending order

Path Params

identifier

string

required

length between 1 and 50

(^[-A-Za-z0-9_]{1,50}$)

The field to use to uniquely identify the contact. This can be a custom identifier or a contact identifer of contactId, email or mobileNumber

value

string

required

length between 1 and 256

The unique value to identify the contact.
Note: Must be the same type as the identifier

collectionName

string

required

length ≤ 255

(^[-A-Za-z_][-A-Za-z0-9_]{1,255}$)

Insight data collection name

Query Params

~modified

string

^gte::\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$

Filter by last modified date.

Note:

The date must be in (ISO 8601 format)

limit

int32

1 to 5000

Maximum number of records to retrieve per page

marker

string

Pagination marker to retrieve the data from

Headers

x-ddg-integration-token

string

/^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/

If you are a partner of Dotdigital and have a verified integration then include your integration tracking token here.

Responses

401

Unauthorized

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Insight data retrieved

400Bad request

404Not found