Sign in
Audit Logs

Search tenant login events

Searches for tenant-level login events with page-number based pagination. Requires a tenantId filter in filter.must. Returns totalPages and totalElements for direct page navigation.

post/admin/audit/v2/tenant-logins

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": 100,
  "firstPageToken": "0",
  "lastPageToken": "12",
  "nextToken": "1",
  "totalPages": 13,
  "totalElements": 1250,
  "events": [
    {
      "eventId": "e5f6a7b8-c9d0-1234-efgh-456789012345",
      "timestamp": "2025-05-29T16:20:45.000Z",
      "username": "billing.user@customer.com",
      "userId": "a47ac10b-58cc-4372-a567-0e02b2c3d482",
      "action": "LOGIN",
      "actionDetails": "Successful login",
      "tenantId": "10138",
      "tenantUsername": "billing.user",
      "namespace": "tenant",
      "clientid": "zuora-ui",
      "clienttype": "BROWSER",
      "ipaddress": "203.0.113.50",
      "hostname": "one.zuora.com",
      "status": "SUCCESS",
      "logintype": "PASSWORD",
      "browsertype": "Chrome",
      "browserversion": "125.0.6422.76"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 4 revisions of this API.