This endpoint returns the customer journey details of all known individuals since the provided event_date or the last 90 days of the journey for an email provided. If the event_date parameter is provided, the API will return the customer journey details of all known individuals since the provided event_date, as well as the last 90 days' journey details for individuals who became known since the event_date. In the absence of both parameters, this API will return the customer journey data of the last 24 hours.
In other words, the API returns customer journey details for two different groups of individuals, depending on the parameters provided:
If an email address is provided, the API returns the last 90 days' journey details for that email address.
If an event_date parameter is provided, the API returns the customer journey details for all known individuals since the provided event_date, as well as the last 90 days' journey details for individuals who became known since the event_date.
If neither parameter is provided, the API returns the last 24 hours of customer journey data for all known individuals.
Here's an example of how this API endpoint could be used:
Let's say there is a marketing campaign running from July 1, 2022 to August 31, 2022. We can use the API endpoint and specify the event_date parameter as "2022-07-01" and the API will return the journey details for all individuals who became known on or after July 1, 2022 (includes all individuals who have become known to the system since that date, regardless of whether they were already known prior to that date or not), as well as the last 90 days' journey details for those individuals who became known since July 1, 2022 (these individuals may have started their journey before this date, but they were not known to the system until after this date). This will allow us to see the journey details for all individuals who were potentially influenced by the marketing campaign during the specified time period.
Alternatively, let's say we want to retrieve journey details for a specific email address, "[email protected]". We can use the API endpoint and specify the email address parameter as "[email protected]" and the API will return the journey details for that email address for the last 90 days. This will allow us to see the journey details for a specific individual and understand their engagement with the brand over the last 90 days.
Finally, if we don't specify any parameter, the API will return the journey details for all known individuals for the last 24 hours. This could be useful if we want to get a quick overview of recent customer engagement with the brand.
QUERY PARAMS
- event_date (format: YYYY-MM-DD)