---
title: AuditFilter
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/auditfilter
---

# AuditFilter

A single filter condition in an audit query request, specifying the field to filter on, the comparison operator, and one or more values to match against.

## Declaration

```data
object AuditFilter
```

## Properties

field: The name of the field to filter on. Standard event fields always available: eventTime, entityType, entityId, userId, userType, txnId. Parent identifier fields vary by entityType: adAccountId (for Campaign, AdGroup), campaignId (for AdGroup, Keyword, NegativeKeyword), adGroupId (for Keyword, NegativeKeyword). For non-time fields, the API supports only EQUALS and IN. It reserves GREATER_THAN, LESS_THAN, and BETWEEN for eventTime. operator: The comparison operator to apply. See AuditOperator. For most fields use IN. For eventTime use BETWEEN for a bounded range, or GREATER_THAN or LESS_THAN for an open-ended range. value: One or more filter values as strings. See AuditFilter.Value. For BETWEEN, provide exactly two values representing the inclusive lower and upper bounds.

## Discussion

Discussion The AuditFilter object is the building block for narrowing change history query results. Each filter targets a single field and applies the specified operator against the provided values. The system combines multiple filters in the same request with logical AND. Every AuditQuery request requires an eventTime filter: { "field": "eventTime", "operator": "BETWEEN", "value": ["2025-03-01", "2025-03-31"] } { "field": "eventTime", "operator": "GREATER_THAN", "value": "2025-03-01T00:00:00.000Z" } { "field": "eventTime", "operator": "LESS_THAN", "value": "2025-03-31T23:59:59.999Z" } Use IN for categorical filters: { "field": "entityType", "operator": "IN", "value": ["Campaign", "AdGroup"] } { "field": "eventType", "operator": "IN", "value": ["UPDATE"] } { "field": "userType", "operator": "IN", "value": ["CUSTOMER_API"] } Each field accepts only certain operators and value formats, summarized below.  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  Example {   "field": "campaignId",   "operator": "IN",   "value": ["123456789", "987654321"] }

## Topics

### Dictionaries

- [AuditFilter.Value](apple-ads-platform-api/auditfilter/value-data.dictionary.md)

## See Also

- [AuditQuery](apple-ads-platform-api/auditquery.md)
- [AuditSorting](apple-ads-platform-api/auditsorting.md)
- [Pagination](apple-ads-platform-api/pagination.md)