Sign in
Audit Logs

Search tenant object change events

Searches for tenant-level object change events with page-number based pagination. Requires a tenantId filter in filter.must. Optionally accepts an objectType filter with values such as USER, ROLE, and PERMISSION. Returns totalPages and totalElements for direct page navigation.

post/admin/audit/v2/tenant-objects

Headers

Content-Typestring required

The Content-Type of the request must be application/json.

Accept-Encodingstring

Include the Accept-Encoding: gzip header to compress responses as a gzipped file.

Zuora-Track-Idstring

A custom identifier for tracing the API call. If you specified a tracing identifier in the request headers, Zuora returns the same tracing identifier. Otherwise, Zuora does not set this header.

Zuora-Entity-Idsstring

An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in.

Zuora-Org-Idsstring

Comma separated IDs. If you have Zuora Multi-Org enabled, you can use this header to specify which orgs to perform the operation in.

Request body

Response

OK

countinteger

The number of events returned in the current page.

firstPageTokenstring
lastPageTokenstring
nextTokenstring nullable
previousTokenstring nullable
totalPagesinteger

The total number of pages available for the query.

totalElementsinteger

The total number of events that match the query.

Example response

{
  "count": 45,
  "firstPageToken": "0",
  "lastPageToken": "0",
  "totalPages": 1,
  "totalElements": 45,
  "events": [
    {
      "eventId": "c9d0e1f2-a3b4-5678-ijkl-890123456789",
      "timestamp": "2025-05-29T08:45:00.000Z",
      "username": "tenant.admin@customer.com",
      "userId": "c47ac10b-58cc-4372-a567-0e02b2c3d484",
      "action": "CREATE",
      "actionDetails": "New user created with Billing Admin role",
      "objectType": "USER",
      "objectId": "usr-new-001",
      "objectname": "new.user@customer.com",
      "tenantId": "10138",
      "namespace": "tenant",
      "changetype": "CREATE",
      "itemtype": "USER",
      "itemid": "usr-new-001",
      "transactionid": "txn-usr-101"
    }
  ]
}

Changes