Skip to main content
API docs by Redocly

Audit Logs API (v1.0)

Managing audit logs

Get logs

Returns paginated and filtered audit logs.

Authorizations:
iam_token_account_scoped
query Parameters
cursor
string
Example: cursor=eyJpZCI6IjU3ZmRmNWFkLWUwZDMtNDNkNS04ODUxLTIzYjhmMjVjMGQ5NSIsImNyZWF0ZWRfYXQiOiIyMDI1LTA2LTI1VDEwOjA1OjE1LjAyNzk1ODMzN1oifQ

An optional, opaque pagination token. Pass the next_cursor value returned in the previous POST /v1/logs response to retrieve the next page of log entries. If absent, the first page of results is returned.

dir
string
Enum: "backward" "forward"

An optional parameter that controls the chronological direction of the returned log entries. Use forward to sort results from oldest to newest. Use backward to sort results from newest to oldest. If omitted, the default is forward.

limit
integer [ 1 .. 1000 ]

An optional parameter that sets the maximum number of log entries to return per page. Must be a positive integer no greater than 1000. If omitted, the service’s default page size is applied.

Request Body schema: application/json
event_saved_time_from
string <date-time>

Start of the log time range, in RFC 3339 (ISO 8601) format.

event_saved_time_to
string <date-time>

End of the log time range, in RFC 3339 (ISO 8601) format.

event_types
Array of strings

Filter logs by one or more event types.

project_ids
Array of strings

Filter logs by one or more project IDs.

source_types
Array of strings

Filter logs by one or more source types.

Responses

Request samples

Content type
application/json
{
  • "event_saved_time_from": "2025-06-10T13:00:01+00:00",
  • "event_saved_time_to": "2025-07-10T13:00:01+00:00",
  • "event_types": [
    ],
  • "project_ids": [
    ],
  • "source_types": [
    ]
}

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "data": [
    ]
}