---
title: "Search global setting change events"
method: POST
path: "/admin/audit/v2/global-settings"
tags: ["Audit Logs"]
---

# Search global setting change events

`POST /admin/audit/v2/global-settings`

Searches for global setting change events with page-number based pagination. Returns totalPages and totalElements for direct page navigation. No filter is required for global setting queries.

## Headers

- `Content-Type` string, required
- `Accept-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string

## Request body

- object
  - `dateRange` object — Specifies the date range for the audit event query.
    - `startDate` string, date-time — Specifies the start timestamp of the query range.
    - `endDate` string, date-time — Specifies the end timestamp of the query range.
  - `pagination` object — Specifies the pagination settings for the query.
    - `items` integer — Specifies the number of records returned per page.
    - `page` integer — Specifies the zero-based page number to retrieve.
  - `filter` object — Specifies the filter conditions for the query.
    - `must` object[] — Specifies the conditions that all matching records must satisfy.
      - `field` string — Specifies the field name to filter on.
      - `values` string[] — Specifies the values to match against the field.
      - `operator` string — Specifies the comparison operator for the filter condition.
    - `should` object[] — Specifies the conditions of which at least one must be satisfied.
      - `field` string — Specifies the field name to filter on.
      - `values` string[] — Specifies the values to match against the field.
      - `operator` string — Specifies the comparison operator for the filter condition.
    - `exclude` object[] — Specifies the conditions used to exclude matching records.
      - `field` string — Specifies the field name to filter on.
      - `values` string[] — Specifies the values to match against the field.
      - `operator` string — Specifies the comparison operator for the filter condition.
  - `sort` object — Specifies the sort settings for the query.
    - `field` string — Specifies the field used to sort the results.
    - `order` string — Specifies the sort direction.

## Response `200`

OK

- object
  - `count` integer — The number of events returned in the current page.
  - `firstPageToken` string
  - `lastPageToken` string
  - `nextToken` string, nullable
  - `previousToken` string, nullable
  - `totalPages` integer — The total number of pages available for the query.
  - `totalElements` integer — The total number of events that match the query.
  - `events` object[]
    - `eventId` string
    - `timestamp` string, date-time
    - `username` string
    - `userId` string
    - `action` string
    - `actionDetails` string
    - `objectType` string
    - `objectId` string
    - `objectname` string
    - `namespace` string
    - `settingtype` string
    - `changetype` string
    - `transactionid` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)
