Audit Logs

Audit logs provide a complete history of changes made to campaigns, packages and lines in the last 30 days. Use the audit logs to monitor performance, manage pacing and troubleshoot issues.

These logs capture updates made through both the DSP UI and the Traffic API, giving full visibility into all changes across an account.

Endpoint

/traffic/{entityType}/{entityId}/auditlog

Use the following HTTP methods:

Use the GET method to view audit logs for a specific campaign, package or line.

Parameters

Audit Log Object

The Audit Log object contains the following fields:

Field	Description	Data Type
`timestamp`	The date and time when the change was made.	`string`
`field`	The name of the field that was changed (for example, "name", "status", "end_date").	`string`
`action`	The type of action performed. Allowed values: • `Create` • `Update` • `Delete`	`string`
`oldValue`	The value of the field before the change. For Create actions, this will be null.	`string/integer`
`newValue`	The value of the field after the change. For Delete actions, this will be null.	`string/integer`
`user`	The email address of the user who made the change.	`string`
`entityId`	The ID of the entity that was modified.	`Integer`
`entityType`	The type of entity that was modified (CAMPAIGN, LINE, PACKAGE).	`string`

Read Audit Logs

GET /traffic/{entityType}/{entityId}/auditlog

Parameters

Parameters	Parameter Type	Description	Data Type	Required/Optional
`entityType`	path	Specifies the type of entity. Allowed values: • `campaigns` • `packages` • `lines`	`string`	Y
`entityId`	path	Specifies the ID of the campaign, package, or line.	`Integer`	Y
`startDate`	query	Start date for the audit log query (for example, 2026-01-01T00:00:00Z).	`string`	N
`endDate`	query	End date for the audit log query (for example, 2026-01-31T23:59:59Z).	`string`	N
`limit`	query	Maximum number of audit log records to return per page. Default is 100.	`integer`	N
`page`	query	Page number for pagination. Default is 1.	integer	N

Note
Users can only retrieve audit logs for entities they have permission to access.
If no date range is specified, audit logs from the last 7 days are returned.
Date format must be ISO 8601 compliant (YYYY-MM-DDTHH:mm:ssZ).

Sample Request URL (Campaign-Level)

GET https://dspapi.admanagerplus.yahoo.com/traffic/campaigns/12345/auditlog?startDate=2025-12-01T00:00:00Z&endDate=2026-01-01T00:00:00Z&limit=50&page=1

Sample Request URL (Package-Level)

GET https://dspapi.admanagerplus.yahoo.com/traffic/packages/242456/auditlog?startDate=2026-01-01T00:00:00Z&endDate=2026-01-31T23:59:59Z&limit=100&page=1

Sample Request URL (Line-Level)

GET https://dspapi.admanagerplus.yahoo.com/traffic/lines/54321/auditlog?startDate=2026-02-01T00:00:00Z&endDate=2026-02-28T23:59:59Z

Sample Response

{
    "response": [
        {
            "auditLogs": [
                {
                    "timestamp": "2026-04-16T14:51:40Z",
                    "field": "client_status_id",
                    "action": "Update",
                    "oldValue": "Stop End Date",
                    "newValue": "Pause",
                    "user": "testuser@yahooinc.com"
                }
            ],
            "entityId": 123456,
            "entityType": "ORDER"
        },
        {
            "auditLogs": [
                {
                    "timestamp": "2026-04-16T14:51:40Z",
                    "field": "end_date",
                    "action": "Update",
                    "oldValue": "2026-03-31 23:59:59",
                    "newValue": "2026-04-30 23:59:59",
                    "user": "testuser@yahooinc.com"
                }
            ],
            "entityId": 12345,
            "entityType": "ORDER"
        }
    ],
    "errors": null,
    "timeStamp": "2026-04-21T17:57:09Z"
}