<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/AuditSummary",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:AuditSummary"
  },
  "title" : "AuditSummary"
}
-->

# AuditSummary

One row in the query change history response, grouping a single actor’s entity changes in one transaction by entity type and event type.

```
object AuditSummary
```

## Overview

The query endpoint returns one `AuditSummary` row per unique (`userType`, `modifiedBy`, `transactionId`, `eventType`, `entityType`) combination. The `count` field reports how many entity changes of that type, user, and transaction grouping the row includes. Fetching full field-level data for those changes requires the per-entity `detailId`, which this summary object does not provide on its own. See the Discussion section below.

### Example

```json
{
  "transactionId": "998877665",
  "eventType": "UPDATE",
  "eventTime": "2025-03-15T14:30:00.000Z",
  "entityType": "AdGroup",
  "count": 3,
  "metas": [],
  "userType": "CUSTOMER",
  "modifiedBy": "111222333"
}
```

## Discussion

### Use `count` to decide fetch strategy

Each `AuditSummary` row reports a `count` of entity changes for that entity type, user, and transaction grouping. The detail endpoint (`GET /v1/change-history/{detailId}` ([`Get Change History Detail`](/documentation/Apple-Ads-Platform-API/Get-change-details-by-detailId))) requires a composite `detailId` in the form `EntityType.entityId.txnId`, but `AuditSummary` doesn’t include `entityId` directly.

That means when you don’t request metadata options, you can’t construct `detailId` from a row alone. When you set metadata options to `latest` or `snapshot`, though, each entry in `metas` already includes a ready-to-use `detailId`, so you don’t need a separate lookup.

## Topics

### Dictionaries

[`object AuditSummary.Metas`](/documentation/Apple-Ads-Platform-API/AuditSummary/Metas-data.dictionary)

An array of per-entity metadata entries, populated when the request includes metadata options.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)