---
search:
  tags:
    - Audit log
    - GET
seo:
  description: >-
    Events recorded in the token's organization about projects, environments,
    components,… Reference for the GET /audit-events endpoint in the Platform
    API.
sidebar:
  label: List audit events
  badge: GET
title: List audit events
type: openapi-operation
---
Events recorded in the token's organization about projects, environments, components, variables, pipelines, clusters and integrations, newest first. Without a target filter it requires audit:read on the organization and returns every event, including denials and their origin. With `target_type` `project` or `environment` and a `target_id`, the read Permission on that resource is enough: the events about it and everything it contains are returned, without denials or origin. The Auth API serves the organization's own events (members, Roles, OAuth applications, sign-ins) with the same schema and filters.

`GET /audit-events`

**Responses**

- `200` — A page of events.
- `default` — Error

Response example, 200:

```json
{
  "events": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "source": "auth",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "occurred_at": "2019-08-24T14:15:22Z",
      "action": "string",
      "actor": {
        "type": "user",
        "id": "string",
        "email": "string",
        "name": "string"
      },
      "targets": [
        {
          "type": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "relation": "primary"
        }
      ],
      "affected_user": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "email": "string",
        "name": "string"
      },
      "outcome": "allowed",
      "denial_reason": "string",
      "changed_fields": [
        "string"
      ],
      "changes": {
        "before": {},
        "after": {}
      },
      "metadata": {},
      "origin": {
        "ip": "string",
        "user_agent": "string",
        "entry_point": "http",
        "request_id": "string"
      }
    }
  ],
  "next_cursor": "string"
}
```
