---
title: "List all events"
method: GET
path: "/api/v4/events"
tags: ["events"]
---

# List all events

`GET /api/v4/events`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/events`
- Auth: none declared

Lists all events for the authenticated user. Does not return events associated with epics or merge requests. Returns bulk push events with limited commit details.

## Query parameters

- `scope` string
- `page` integer
- `per_page` integer
- `action` string
- `target_type` 'issue' | 'milestone' | 'merge_request' | 'note' | 'project' | 'snippet' | 'user' | 'wiki' | 'design'
- `before` string, date
- `after` string, date
- `sort` 'asc' | 'desc'

## Response `200`

List all events

- APIEntitiesEvent[]
  - `id` integer, required
  - `project_id` integer, required
  - `action_name` string, required
  - `target_id` integer, required
  - `target_iid` integer, required
  - `target_type` string, required
  - `author_id` integer, required
  - `target_title` string, required
  - `created_at` string, required
  - `note` APIEntitiesNote
    - `id` integer, required
    - `type` string, required
    - `body` string, required
    - `author` APIEntitiesUserBasic, required: API_Entities_UserBasic model
      - `id` integer, required
      - `username` string, required
      - `public_email` string, required
      - `name` string, required
      - `state` string, required
      - `locked` boolean, required
      - `avatar_url` string, required
      - `avatar_path` string
      - `custom_attributes` APIEntitiesCustomAttribute[]
        - `key` string, required
        - `value` string, required
      - `web_url` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `system` boolean, required
    - `noteable_id` integer, required
    - `noteable_type` string, required
    - `project_id` integer, required
    - `commit_id` string
    - `position` object
    - `resolvable` boolean, required
    - `resolved` boolean
    - `resolved_by` APIEntitiesUserBasic: API_Entities_UserBasic model
      - `id` integer, required
      - `username` string, required
      - `public_email` string, required
      - `name` string, required
      - `state` string, required
      - `locked` boolean, required
      - `avatar_url` string, required
      - `avatar_path` string
      - `custom_attributes` APIEntitiesCustomAttribute[]
        - `key` string, required
        - `value` string, required
      - `web_url` string, required
    - `resolved_at` string, date-time
    - `suggestions` APIEntitiesSuggestion: API_Entities_Suggestion model
      - `id` integer, required
      - `from_line` integer, required
      - `to_line` integer, required
      - `appliable` boolean, required
      - `applied` boolean, required
      - `from_content` string, required
      - `to_content` string, required
    - `confidential` boolean, required
    - `internal` boolean, required
    - `imported` boolean, required
    - `imported_from` string, required
    - `noteable_iid` integer, required
    - `commands_changes` object, required
  - `author` APIEntitiesUserBasic: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `wiki_page` APIEntitiesWikiPageBasic: API_Entities_WikiPageBasic model
    - `format` string, required
    - `slug` string, required
    - `title` string, required
    - `wiki_page_meta_id` integer, required
  - `imported` boolean, required
  - `imported_from` string, required
  - `push_data` APIEntitiesPushEventPayload
    - `commit_count` integer, required
    - `action` string, required
    - `ref_type` string, required
    - `commit_from` string, required
    - `commit_to` string, required
    - `ref` string, required
    - `commit_title` string, required
    - `ref_count` integer, required
  - `author_username` string, required

## Other responses

- `401`: Unauthorized

---

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