List all instance audit events

GET

/api/v4/audit_events

• GitLab REST API

Lists all available instance audit events, limited to a maximum of 30 days for each query.

Authorizations

• http
• oauth2

Parameters

Query Parameters

entity_type

required

string

>= 1 characters

Allowed values: Project User Group Gitlab::Audit::InstanceScope

Return audit events for the specified entity type

entity_id

integer

nullable

Return audit events for the specified entity ID. If defined, the request must also include the entity_type attribute.

created_after

string format: date-time

nullable

Return audit events created after the specified time

Example

2016-01-19T09:05:50.355Z

created_before

string format: date-time

nullable

Return audit events created before the specified time

Example

2016-01-19T09:05:50.355Z

page

integer

default: 1 nullable

Current page number

Example

1

per_page

integer

default: 20 nullable

Number of items per page

Example

20

Responses

200

OK

Media type application/json

object

id

integer format: int64

author_id

integer format: int64

entity_id

integer format: int64

entity_type

string

event_name

string

details

object

created_at

string format: date-time

Example ^generated

{
  "id": 1,
  "author_id": 1,
  "entity_id": 1,
  "entity_type": "example",
  "event_name": "example",
  "details": {},
  "created_at": "2026-04-15T12:00:00Z"
}

400

Bad Request