---
title: AuditQuery.Options
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/auditquery/options-data.dictionary
---

# AuditQuery.Options

A flat key-value map of additional query controls.

## Declaration

```data
object AuditQuery.Options
```

## Properties

needTotals: Skip the COUNT query when set to false, so pagination.totalCount returns 0 instead of the full result count. Accepted values: true, false. Default: true. timeZone: Controls how the API interprets eventTime filter values. UTC treats values as UTC. ORTZ interprets values in the org’s configured timezone and converts them to UTC server-side. Accepted values: UTC, ORTZ. metadata: Controls entity metadata included in change detail responses. none returns no metadata, latest joins current entity metadata, snapshot uses metadata captured at the time of the event. Accepted values: none, latest, snapshot. Default: none. Any Key: The API accepts any key other than needTotals, timeZone, or metadata as an arbitrary string value, but it has no effect on query behavior.

## Discussion

Discussion The options field has three well-known keys (needTotals, timeZone, and metadata), each with a fixed set of accepted string values and a default. The API accepts any other key as a plain string (labeled Any Key on the reference page) and passes it through without affecting the query. All keys and values in options are strings: pass needTotals as "true" or "false", not as a boolean, and metadata as "none", "latest", or "snapshot".