--- updatedAt: 2026-05-28T14:47:28.000Z agentTools: projectIndex: https://marketing.developer.dotdigital.com/llms.txt --- # Retrieve data for contact-scoped Insight data collection Retrieves records from across all contacts for a contacts scoped Insight data collection

***Note:** All data is returned in ascending order* # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Insight data service", "description": "Manage Insight data collections and records at both account and contact level. Use this API to bulk-import records via asynchronous upsert, retrieve and update individual records, create and delete collections, empty collections, and poll the status of import or asynchronous operations. Insight data makes structured behavioural and transactional data — such as orders, product catalogues, and web activity — available to drive personalisation, segmentation, and product recommendations across your campaigns.\n", "version": "3.3.1" }, "externalDocs": { "description": "Learn more about Dotdigital APIs", "url": "https://developer.dotdigital.com" }, "servers": [ { "url": "https://{region}-api.dotdigital.com", "variables": { "region": { "description": "The Dotdigital region id your account belongs to", "enum": [ "r1", "r2", "r3" ], "default": "r1" } } } ], "security": [ { "basicAuth": [] } ], "paths": { "/insightData/v3/contacts/{collectionName}": { "get": { "summary": "Retrieve data for contact-scoped Insight data collection", "description": "Retrieves records from across all contacts for a contacts scoped Insight data collection

\n***Note:** All data is returned in ascending order*", "operationId": "getAllContactsInsightData", "parameters": [ { "name": "collectionName", "in": "path", "description": "Insight data collection name", "required": true, "schema": { "maxLength": 255, "pattern": "(^[-A-Za-z_][-A-Za-z0-9_]{1,255}$)", "type": "string" } }, { "name": "x-ddg-integration-token", "in": "header", "description": "If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.", "required": false, "schema": { "pattern": "/^(?:\\{{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})$/", "type": "string", "example": "5a96bc79-19a7-4544-973b-e2da0c9136f9" } }, { "name": "~modified", "in": "query", "description": "Filter by last modified date.
\n***Note:***\n* The date must be in ([ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601))", "schema": { "pattern": "^gte::\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$", "type": "string" }, "examples": { "Greater than or equal to modified date": { "value": "gte::2021-12-17T00:00:00Z" } } }, { "name": "limit", "in": "query", "description": "Maximum number of records to retrieve per page", "schema": { "maximum": 5000, "minimum": 1, "type": "integer", "format": "int32", "example": 1000 } }, { "name": "marker", "in": "query", "description": "Pagination marker to retrieve the data from", "schema": { "type": "string", "example": "RXhhbXBsZSBhbXJrZXIgdmFsdWU=" } } ], "responses": { "200": { "description": "Insight data retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inline_response_200_5" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorResponse" }, "example": { "errorCode": "insightData:invalidId", "description": "The collectionName value 'my collection' is invalid" } } } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/errorResponse" }, "examples": { "collectionNotFound": { "summary": "Collection not found", "value": { "errorCode": "insightData:collectionNotFound", "description": "The collection could not be found", "details": [ { "item": "myOrders", "description": "Not found" } ] } } } } } } } } } }, "components": { "schemas": { "insightRecord": { "required": [ "json", "key" ], "type": "object", "properties": { "key": { "type": "string", "description": "The unique key for the record", "example": "24938" }, "json": { "type": "object", "additionalProperties": true, "format": "json", "example": { "PurchaseDate": "2020-01-01T09:40:18.527Z", "TotalExTax": 56, "TotalIncTax": 67.2, "SalesChannel": "In store", "SalesSubChannel": "Manchester", "Product": { "Name": "Armani Jeans beanie hat", "Brand": "Armani Jeans", "Department": "Menswear", "Category": "Hat", "PriceExTax": 56, "ProductID": "24938" } } } }, "description": "An Insight data record" }, "returnedInsightRecord": { "description": "An Insight data record", "allOf": [ { "$ref": "#/components/schemas/insightRecord" }, { "required": [ "created", "updated" ], "type": "object", "properties": { "created": { "type": "string", "description": "ISO 8601 UTC timestamp for when the record was created", "format": "date-time" }, "updated": { "type": "string", "description": "ISO 8601 UTC timestamp for when the record was last updated", "format": "date-time" }, "ownerContactId": { "$ref": "#/components/schemas/contactId" } }, "additionalProperties": false } ] }, "errorResponse": { "required": [ "description", "errorCode" ], "type": "object", "properties": { "errorCode": { "type": "string", "description": "Unique error code" }, "description": { "type": "string", "description": "Description of the issue" }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/errorResponse_details" } } } }, "paginationLinks": { "required": [ "first", "self" ], "type": "object", "properties": { "self": { "$ref": "#/components/schemas/paginationLinks_self" }, "first": { "$ref": "#/components/schemas/paginationLinks_first" }, "prev": { "$ref": "#/components/schemas/paginationLinks_prev" }, "next": { "$ref": "#/components/schemas/paginationLinks_next" }, "last": { "$ref": "#/components/schemas/paginationLinks_last" } }, "description": "Pagination links" }, "contactId": { "minimum": 0, "type": "integer", "description": "Immutable unique identifier for the contact", "example": 35212311 }, "inline_response_200_5": { "required": [ "_items", "_links" ], "type": "object", "properties": { "_links": { "$ref": "#/components/schemas/paginationLinks" }, "_items": { "maxItems": 1000, "type": "array", "description": "The returned Insight data records", "items": { "$ref": "#/components/schemas/returnedInsightRecord" } } } }, "errorResponse_details": { "required": [ "description", "item" ], "type": "object", "properties": { "item": { "type": "string", "description": "Item the error is associated with, for example, field name, unique identifier for an entity or item in batch" }, "description": { "type": "string", "description": "Description of the error" } } }, "paginationLinks_self": { "required": [ "link", "marker" ], "type": "object", "properties": { "marker": { "type": "string", "description": "Pagination marker to be passed to API calls to retrieve this data page" }, "link": { "type": "string", "description": "Link to retrieve the data page" } }, "description": "Details for accessing this data page via pagination" }, "paginationLinks_first": { "required": [ "link", "marker" ], "type": "object", "properties": { "marker": { "type": "string", "description": "Pagination marker to be passed to API calls to retrieve this data page" }, "link": { "type": "string", "description": "Link to retrieve the data page" } }, "description": "Details for accessing the first page worth of data" }, "paginationLinks_prev": { "required": [ "link", "marker" ], "type": "object", "properties": { "marker": { "type": "string", "description": "Pagination marker to be passed to API calls to retrieve this data page" }, "link": { "type": "string", "description": "Link to retrieve the data page" } }, "description": "Details for accessing the previous pagea worth of data" }, "paginationLinks_next": { "required": [ "link", "marker" ], "type": "object", "properties": { "marker": { "type": "string", "description": "Pagination marker to be passed to API calls to retrieve this data page" }, "link": { "type": "string", "description": "Link to retrieve the data page" } }, "description": "Details for accessing the next pages worth of data" }, "paginationLinks_last": { "required": [ "link", "marker" ], "type": "object", "properties": { "marker": { "type": "string", "description": "Pagination marker to be passed to API calls to retrieve this data page" }, "link": { "type": "string", "description": "Link to retrieve the data page" } }, "description": "Details for accessing the last pages worth of data" } }, "securitySchemes": { "basicAuth": { "type": "http", "scheme": "basic" } } }, "x-samples-languages": [ "curl", "csharp", "java", "javascript", "node", "python", "php", "ruby" ] } ``` # Sibling pages * [Retrieve records for a contact from Insight data collection](https://marketing.developer.dotdigital.com/reference/getcontactinsightdata.md) * [List Insight data collections for a contact](https://marketing.developer.dotdigital.com/reference/getcontactinsightdatacollections.md) * [Empty Insight data collection for a contact](https://marketing.developer.dotdigital.com/reference/delemptycontactinsightdatacollection.md) * [Retrieve Insight data record for a contact](https://marketing.developer.dotdigital.com/reference/getcontactinsightdatarecord.md) * [Upsert record into Insight data collection for a contact](https://marketing.developer.dotdigital.com/reference/putcontactinsightdatarecord.md) * [Delete record from Insight data collection for a contact](https://marketing.developer.dotdigital.com/reference/delcontactinsightdatarecord.md) * [Deletes multiple records from an contact scoped Insight Data collection.](https://marketing.developer.dotdigital.com/reference/delcontactinsightdatarecords.md)