---
title: "List audit events for a domain"
method: GET
path: "/gdc/domains/{domainId}/auditEvents"
tags: ["auditEvents"]
---

# List audit events for a domain

`GET /gdc/domains/{domainId}/auditEvents`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/domains/{domainId}/auditEvents`
- Auth: none declared

__NOTE:__ Audit events are available only per request and may be subject to an additional charge. For more information, contact your Account Manager. <br/><br/> Returns a paged list of audit events for a specific domain. For more information about audit events, see [Auditing Platform Events](https://help.gooddata.com/doc/enterprise/en/expand-your-gooddata-platform/gooddata-platform-overview/auditing-platform-events#AuditingPlatformEvents-EventTypes). <br/><br/> You must be a domain admin to perform this operation.

## Path parameters

- `domainId` string, required

## Query parameters

- `offset` string
- `limit` integer
- `from` string, date-time
- `to` string, date-time
- `type` string

## Response `200`

List of audit events

- AuditEvents
  - `events` object: A JSON representation of a list of audit events.
    - `items` AuditEvent[]
      - `event` object: The JSON representation of one audit event
        - `id` string: The unique ID of the event.
        - `userLogin` string: The login email of the user.
        - `occurred` string, date-time: The timestamp when the event occurred.
        - `recorded` string, date-time: The timestamp when the event was recorded by the system (the `from` and `to` parameters apply to this value).
        - `userIp` string: Public IP of the user who initiated this particular action.
        - `success` boolean: The flag if the operation performed under this event was successful.
        - `type` string: A type of the event.
        - `params` object: A string/string map of additional context information.
        - `links` object: A string/string map of the affected resources.
    - `paging` object: The collection of properties containing paging information.
      - `next` string: Returns either the URI of the next page or `null` when there are no more pages. The returned URI contains the offset key, which is the ID of the last event on the page. You can use this ID as the value for the offset parameter in the subsequent API calls.
    - `links` object: A string/string map of related resources.

## Other responses

- `400`: Bad request (Invalid data in the request)
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)