---
title: "Audit Logs"
slug: "audit-logs"
updated: 2026-05-19T16:04:14Z
published: 2026-05-19T16:04:14Z
canonical: "help.yahooinc.com/audit-logs"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```plaintext
/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

```plaintext
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]
> 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)

```plaintext
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)

```plaintext
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)

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

### Sample Response

```json
{
    "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"
}
```