GET /interaction/v1/interactions/key:{key}/audit/{action}

Retrieves an audit log for one or all versions of a journey by specifying its external key. You can specify different actions to see history related to the creation, modification, activation, deactivation, stopping, and deletion of a journey.

URL Parameters

Specify these parameters in the URL.

Name	Type	Description
`action`	String	Required. The actions to include in the audit log. Specify `all` to return all actions. Possible values: `all` `create` `modify` `publish` `unpublish` `delete`
`key`	String	Required. The external key of the journey to retrieve audit logs for. Specify the key in this format `/interactions/key:{key}/audit/{action}`.

Query Parameters

Use these optional query parameters to further refine the results.

Name	Type	Description
`$page`	Integer	The page number of results to return. The default value is `1`.
`$pageSize`	Integer	The number of items to return in a page of results. The default value is `50`. The minimum value is `1` and the maximum is `50`. This value is only honored if the query string also specifies the `$page` parameter.
`mostRecentVersionOnly`	Boolean	If `true`, the response includes an audit log for the most recent version of the journey. Don’t specify this parameter if you specify the `versionNumber` parameter or if `mostRecentVersionOrRunningOnly` is `true`.
`mostRecentVersionOrRunningOnly`	Boolean	If `true`, the response includes an audit log for the running version of the journey and the next draft version, if one exists. Don’t specify this parameter if you specify the `versionNumber` parameter or if `mostRecentVersionOnly` is `true`.
`status`	String	A journey status value to filter the results by. Possible values are: `Deleted` `Draft` `None` `Paused` `Pausing` `Published` `Resuming` `ScheduledToPublish` `ScheduledToSend` `ScheduledToStop` `Sent` `Stopped` `Unpublished`
`versionNumber`	Integer	The version number of the journey to retrieve audit logs for. If you don’t specify this parameter, the response includes audit logs for all versions of the journey.

Usage

To retrieve audit logs, determine which type of action you want to view. This example returns all actions for version 2 of the specified journey.

1Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
2GET /interaction/v1/interactions/key:YOUR_JOURNEY_KEY/audit/all?versionNumber=2
3Content-Type: application/json
4Authorization: Bearer YOUR_ACCESS_TOKEN

The response is a log that includes these elements:

The current page number of results.
The number of items returned in each page of results.
The total number of items that meet the request parameters.
An Items array. The array includes an object for each action. All objects in the array include these elements:
- The ID, key, name, and description of the journey
- The original definition ID
- The date and time when the action occurred
- The name and ID of the user who performed the action

This example shows an Items array that contains Create, Modify, Publish, and Stop actions.

1{
2  "Page": 1,
3  "PageSize": 50,
4  "Count": 5,
5  "Items": [
6    {
7      "action": "Create",
8      "key": "some-journey-key",
9      "versionNumber": 2,
10      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
11      "originalDefinitionId": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
12      "name": "Complete journey",
13      "description": "This journey contains a trigger, goal and activities",
14      "timeStamp": "2025-10-30T11:49:55.99",
15      "user": {
16        "name": "Test User 1",
17        "UserId": 1234
18      },
19      "executionMode": "Production",
20      "sourceInteraction": {
21        "id": "c3d4e5f6-g7h8-9012-cdef-345678901234",
22        "version": 3,
23        "key": "My journey"
24      }
25    },
26    {
27      "action": "Modify",
28      "key": "some-journey-key",
29      "versionNumber": 2,
30      "id": "d4e5f6g7-h8i9-0123-def0-456789012345",
31      "originalDefinitionId": "e5f6g7h8-i9j0-1234-ef01-567890123456",
32      "name": "Complete journey",
33      "description": "This journey contains a trigger, goal and activities",
34      "timeStamp": "2025-10-30T11:49:55.99",
35      "user": {
36        "name": "Test User 1",
37        "UserId": 1234
38      },
39      "executionMode": "Production"
40    },
41    {
42      "action": "Publish",
43      "key": "some-journey-key",
44      "versionNumber": 2,
45      "id": "f6g7h8i9-j0k1-2345-f012-678901234567",
46      "originalDefinitionId": "g7h8i9j0-k1l2-3456-0123-789012345678",
47      "name": "Complete journey",
48      "description": "This journey contains a trigger, goal and activities",
49      "timeStamp": "2025-10-30T11:49:55.99",
50      "user": {
51        "name": "Test User 2",
52        "userId": 5678
53      },
54      "executionMode": "Production",
55      "publishStatus": "Error",
56      "PublishRequestId": "h8i9j0k1-l2m3-4567-1234-890123456789",
57      "errors": [
58        {
59          "ErrorDetail": "An activity must be created and configured before activation can be successful",
60          "ErrorCode": "VALIDATE_GENERAL_EXCEPTION"
61        },
62        {
63          "ErrorDetail": "An entry event must be configured before activation can be successful",
64          "ErrorCode": "VALIDATE_GENERAL_EXCEPTION"
65        }
66      ]
67    },
68    {
69      "action": "Publish",
70      "key": "some-journey-key",
71      "versionNumber": 2,
72      "id": "i9j0k1l2-m3n4-5678-2345-901234567890",
73      "originalDefinitionId": "j0k1l2m3-n4o5-6789-3456-012345678901",
74      "name": "Complete journey",
75      "description": "This journey contains a trigger, goal and activities",
76      "timeStamp": "2025-10-30T11:49:55.99",
77      "user": {
78        "name": "Test User 2",
79        "userId": 5678
80      },
81      "executionMode": "Production",
82      "publishStatus": "PublishCompleted",
83      "publishRequestId": "k1l2m3n4-o5p6-7890-4567-123456789012"
84    },
85    {
86      "action": "Stop",
87      "key": "some-journey-key",
88      "versionNumber": 2,
89      "id": "l2m3n4o5-p6q7-8901-4567-234567890123",
90      "originalDefinitionId": "m3n4o5p6-q7r8-9012-5678-345678901234",
91      "name": "Complete journey",
92      "description": "This journey contains a trigger, goal and activities",
93      "timeStamp": "2025-10-30T11:49:55.99",
94      "user": {
95        "name": "Test User 1",
96        "userId": 1234
97      },
98      "ContactsEjected": 20
99    }
100  ]
101}

GET /interaction/v1/interactions/key:{key}/audit/{action}

URL Parameters

Query Parameters

Usage

See Also

Contents