# Points de terminaison d’API REST pour les événements

Utilisez l’API REST pour interagir avec GitHub les événements.

## À propos des événements GitHub

GitHub les événements alimentent les différents flux d’activité sur le site.

Vous pouvez utiliser l’API REST pour retourner différents types d’événements déclenchés par l’activité sur GitHub. Pour plus d’informations sur les événements spécifiques que vous pouvez recevoir, consultez [types d’événements GitHub](/fr/enterprise-server@3.22/rest/using-the-rest-api/github-event-types). Des points de terminaison pour les problèmes de dépôt sont également disponibles. Pour plus d’informations, consultez « [Points de terminaison d’API REST pour les événements de problèmes](/fr/enterprise-server@3.22/rest/issues/events) ».

Les événements sont optimisés pour le sondage avec l’en-tête « ETag ». Si aucun nouvel événement n’a été déclenché, vous verrez une réponse « 304 Non modifié » et votre limite de débit actuelle ne changera pas. Il existe également un en-tête « X-Poll-Interval » qui spécifie la fréquence (en secondes) à laquelle vous êtes autorisé à interroger. En cas de charge élevée du serveur, le temps peut augmenter. Respectez l’en-tête.

```shell
$ curl -I http(s)://HOSTNAME/api/v3/users/tater/events
> HTTP/2 200
> X-Poll-Interval: 60
> ETag: "a18c3bded88eb5dbb5c849a489412bf3"

# The quotes around the ETag value are important
$ curl -I http(s)://HOSTNAME/api/v3/users/tater/events \
$    -H 'If-None-Match: "a18c3bded88eb5dbb5c849a489412bf3"'
> HTTP/2 304
> X-Poll-Interval: 60
```

La chronologie comprendra jusqu'à 300 événements. Seuls les événements créés au cours des 30 derniers jours seront pris en compte. Les événements datant de plus de 30 jours ne seront pas inclus (même si le nombre total d’événements dans la chronologie est inférieur à 300).

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.

## List public events

```
GET /events
```

Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

* **304** - Not modified

* **403** - Forbidden

* **503** - Service unavailable

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/events
```

**Response schema (Status: 200):**

Array of `Event`:

* `id`: required, string
* `type`: required, string or null
* `actor`: required, `Actor`:
  * `id`: required, integer
  * `login`: required, string
  * `display_login`: string
  * `gravatar_id`: required, string or null
  * `url`: required, string, format: uri
  * `avatar_url`: required, string, format: uri
* `repo`: required, object:
  * `id`: required, integer
  * `name`: required, string
  * `url`: required, string, format: uri
* `org`: `Actor` (see above)
* `payload`: required, one of:
  * **CreateEvent**
    * `ref`: required, string
    * `ref_type`: required, string
    * `master_branch`: required, string
    * `description`: string or null
    * `pusher_type`: required, string
  * **DeleteEvent**
    * `ref`: required, string
    * `ref_type`: required, string
    * `pusher_type`: required, string
  * **IssuesEvent**
    * `action`: required, string
    * `issue`: required, `Issue`:
      * `id`: required, integer, format: int64
      * `node_id`: required, string
      * `url`: required, string, format: uri
      * `repository_url`: required, string, format: uri
      * `labels_url`: required, string
      * `comments_url`: required, string, format: uri
      * `events_url`: required, string, format: uri
      * `html_url`: required, string, format: uri
      * `number`: required, integer
      * `state`: required, string
      * `state_reason`: string or null, enum: `completed`, `reopened`, `not_planned`, `duplicate`, `null`
      * `title`: required, string
      * `body`: string or null
      * `user`: required, any of:
        * **null**
        * **Simple User**
          * `name`: string or null
          * `email`: string or null
          * `login`: required, string
          * `id`: required, integer, format: int64
          * `node_id`: required, string
          * `avatar_url`: required, string, format: uri
          * `gravatar_id`: required, string or null
          * `url`: required, string, format: uri
          * `html_url`: required, string, format: uri
          * `followers_url`: required, string, format: uri
          * `following_url`: required, string
          * `gists_url`: required, string
          * `starred_url`: required, string
          * `subscriptions_url`: required, string, format: uri
          * `organizations_url`: required, string, format: uri
          * `repos_url`: required, string, format: uri
          * `events_url`: required, string
          * `received_events_url`: required, string, format: uri
          * `type`: required, string
          * `site_admin`: required, boolean
          * `starred_at`: string
          * `user_view_type`: string
      * `labels`: required, array of object
      * `assignees`: array of `Simple User` (see above)
      * `milestone`: required, any of:
        * **null**
        * **Milestone**
          * `url`: required, string, format: uri
          * `html_url`: required, string, format: uri
          * `labels_url`: required, string, format: uri
          * `id`: required, integer
          * `node_id`: required, string
          * `number`: required, integer
          * `state`: required, string, enum: `open`, `closed`, default: `"open"`
          * `title`: required, string
          * `description`: required, string or null
          * `creator`: required, any of:
            * **null**
            * **Simple User**
          * `open_issues`: required, integer
          * `closed_issues`: required, integer
          * `created_at`: required, string, format: date-time
          * `updated_at`: required, string, format: date-time
          * `closed_at`: required, string or null, format: date-time
          * `due_on`: required, string or null, format: date-time
      * `locked`: required, boolean
      * `active_lock_reason`: string or null
      * `comments`: required, integer
      * `pull_request`: object:
        * `merged_at`: string or null, format: date-time
        * `diff_url`: required, string or null, format: uri
        * `html_url`: required, string or null, format: uri
        * `patch_url`: required, string or null, format: uri
        * `url`: required, string or null, format: uri
      * `closed_at`: required, string or null, format: date-time
      * `created_at`: required, string, format: date-time
      * `updated_at`: required, string, format: date-time
      * `draft`: boolean
      * `closed_by`: any of:
        * **null**
        * **Simple User** (see above)
      * `body_html`: string
      * `body_text`: string
      * `timeline_url`: string, format: uri
      * `type`: `Issue Type`:
        * `id`: required, integer
        * `node_id`: required, string
        * `name`: required, string
        * `description`: required, string or null
        * `color`: string or null, enum: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`
        * `created_at`: string, format: date-time
        * `updated_at`: string, format: date-time
        * `is_enabled`: boolean
      * `repository`: `Repository`:
        * `id`: required, integer, format: int64
        * `node_id`: required, string
        * `name`: required, string
        * `full_name`: required, string
        * `license`: required, any of:
          * **null**
          * **License Simple**
        * `forks`: required, integer
        * `permissions`: object
        * `owner`: required, object
        * `private`: required, boolean, default: `false`
        * `html_url`: required, string, format: uri
        * `description`: required, string or null
        * `fork`: required, boolean
        * `url`: required, string, format: uri
        * `archive_url`: required, string
        * `assignees_url`: required, string
        * `blobs_url`: required, string
        * `branches_url`: required, string
        * `collaborators_url`: required, string
        * `comments_url`: required, string
        * `commits_url`: required, string
        * `compare_url`: required, string
        * `contents_url`: required, string
        * `contributors_url`: required, string, format: uri
        * `deployments_url`: required, string, format: uri
        * `downloads_url`: required, string, format: uri
        * `events_url`: required, string, format: uri
        * `forks_url`: required, string, format: uri
        * `git_commits_url`: required, string
        * `git_refs_url`: required, string
        * `git_tags_url`: required, string
        * `git_url`: required, string
        * `issue_comment_url`: required, string
        * `issue_events_url`: required, string
        * `issues_url`: required, string
        * `keys_url`: required, string
        * `labels_url`: required, string
        * `languages_url`: required, string, format: uri
        * `merges_url`: required, string, format: uri
        * `milestones_url`: required, string
        * `notifications_url`: required, string
        * `pulls_url`: required, string
        * `releases_url`: required, string
        * `ssh_url`: required, string
        * `stargazers_url`: required, string, format: uri
        * `statuses_url`: required, string
        * `subscribers_url`: required, string, format: uri
        * `subscription_url`: required, string, format: uri
        * `tags_url`: required, string, format: uri
        * `teams_url`: required, string, format: uri
        * `trees_url`: required, string
        * `clone_url`: required, string
        * `mirror_url`: required, string or null, format: uri
        * `hooks_url`: required, string, format: uri
        * `svn_url`: required, string, format: uri
        * `homepage`: required, string or null, format: uri
        * `language`: required, string or null
        * `forks_count`: required, integer
        * `stargazers_count`: required, integer
        * `watchers_count`: required, integer
        * `size`: required, integer
        * `default_branch`: required, string
        * `open_issues_count`: required, integer
        * `is_template`: boolean, default: `false`
        * `topics`: array of string
        * `has_issues`: required, boolean, default: `true`
        * `has_projects`: required, boolean, default: `true`
        * `has_wiki`: required, boolean, default: `true`
        * `has_pages`: required, boolean
        * `has_discussions`: boolean, default: `false`
        * `has_pull_requests`: boolean, default: `true`
        * `pull_request_creation_policy`: string, enum: `all`, `collaborators_only`
        * `archived`: required, boolean, default: `false`
        * `disabled`: required, boolean
        * `visibility`: string, default: `"public"`
        * `pushed_at`: required, string or null, format: date-time
        * `created_at`: required, string or null, format: date-time
        * `updated_at`: required, string or null, format: date-time
        * `allow_rebase_merge`: boolean, default: `true`
        * `temp_clone_token`: string
        * `allow_squash_merge`: boolean, default: `true`
        * `allow_auto_merge`: boolean, default: `false`
        * `delete_branch_on_merge`: boolean, default: `false`
        * `allow_update_branch`: boolean, default: `false`
        * `squash_merge_commit_title`: string, enum: `PR_TITLE`, `COMMIT_OR_PR_TITLE`
        * `squash_merge_commit_message`: string, enum: `PR_BODY`, `COMMIT_MESSAGES`, `BLANK`
        * `merge_commit_title`: string, enum: `PR_TITLE`, `MERGE_MESSAGE`
        * `merge_commit_message`: string, enum: `PR_BODY`, `PR_TITLE`, `BLANK`
        * `allow_merge_commit`: boolean, default: `true`
        * `allow_forking`: boolean
        * `web_commit_signoff_required`: boolean, default: `false`
        * `open_issues`: required, integer
        * `watchers`: required, integer
        * `starred_at`: string
        * `anonymous_access_enabled`: boolean
        * `code_search_index_status`: object
      * `performed_via_github_app`: any of:
        * **null**
        * **GitHub app**
          * `id`: required, integer
          * `slug`: string
          * `node_id`: required, string
          * `client_id`: string
          * `owner`: required, one of:
            * **Simple User**
            * **Enterprise**
          * `name`: required, string
          * `description`: required, string or null
          * `external_url`: required, string, format: uri
          * `html_url`: required, string, format: uri
          * `created_at`: required, string, format: date-time
          * `updated_at`: required, string, format: date-time
          * `permissions`: required, object, additional properties: string
          * `events`: required, array of string
          * `installations_count`: integer
      * `author_association`: string, enum: `COLLABORATOR`, `CONTRIBUTOR`, `FIRST_TIMER`, `FIRST_TIME_CONTRIBUTOR`, `MANNEQUIN`, `MEMBER`, `NONE`, `OWNER`
      * `reactions`: `Reaction Rollup`:
        * `url`: required, string, format: uri
        * `total_count`: required, integer
        * `+1`: required, integer
        * `-1`: required, integer
        * `laugh`: required, integer
        * `confused`: required, integer
        * `heart`: required, integer
        * `hooray`: required, integer
        * `eyes`: required, integer
        * `rocket`: required, integer
      * `sub_issues_summary`: `Sub-issues Summary`:
        * `total`: required, integer
        * `completed`: required, integer
        * `percent_completed`: required, integer
      * `parent_issue_url`: string or null, format: uri
      * `pinned_comment`: any of:
        * **null**
        * **Issue Comment**
          * `id`: required, integer, format: int64
          * `node_id`: required, string
          * `url`: required, string, format: uri
          * `body`: string
          * `body_text`: string
          * `body_html`: string
          * `html_url`: required, string, format: uri
          * `user`: required, any of:
            * **null**
            * **Simple User**
          * `created_at`: required, string, format: date-time
          * `updated_at`: required, string, format: date-time
          * `issue_url`: required, string, format: uri
          * `author_association`: string, enum: `COLLABORATOR`, `CONTRIBUTOR`, `FIRST_TIMER`, `FIRST_TIME_CONTRIBUTOR`, `MANNEQUIN`, `MEMBER`, `NONE`, `OWNER`
          * `performed_via_github_app`: any of:
            * **null**
            * **GitHub app**
          * `reactions`: object
          * `pin`: any of:
            * **null**
            * **Pinned Issue Comment**
          * `minimized`: any of:
            * **null**
            * **Minimized Issue Comment**
      * `issue_dependencies_summary`: `Issue Dependencies Summary`:
        * `blocked_by`: required, integer
        * `blocking`: required, integer
        * `total_blocked_by`: required, integer
        * `total_blocking`: required, integer
      * `issue_field_values`: array of `Issue Field Value`:
        * `issue_field_id`: required, integer, format: int64
        * `issue_field_name`: string
        * `node_id`: required, string
        * `data_type`: required, string, enum: `text`, `single_select`, `multi_select`, `number`, `date`
        * `value`: required, any of:
          * **string**
          * **number**
          * **integer**
        * `single_select_option`: object or null
        * `multi_select_options`: array of object or null
    * `assignee`: `Simple User` (see above)
    * `assignees`: array of `Simple User` (see above)
    * `label`: `Label`:
      * `id`: required, integer, format: int64
      * `node_id`: required, string
      * `url`: required, string, format: uri
      * `name`: required, string
      * `description`: required, string or null
      * `color`: required, string
      * `default`: required, boolean
    * `labels`: array of `Label` (see above)
  * **IssueCommentEvent**
    * `action`: required, string
    * `issue`: required, `Issue` (see above)
    * `comment`: required, `Issue Comment` (see above)
  * **ForkEvent**
    * `forkee`: required, object:
      * `id`: integer
      * `node_id`: string
      * `name`: string
      * `full_name`: string
      * `private`: boolean
      * `owner`: `Simple User` (see above)
      * `html_url`: string
      * `description`: string or null
      * `fork`: boolean
      * `url`: string
      * `forks_url`: string
      * `keys_url`: string
      * `collaborators_url`: string
      * `teams_url`: string
      * `hooks_url`: string
      * `issue_events_url`: string
      * `events_url`: string
      * `assignees_url`: string
      * `branches_url`: string
      * `tags_url`: string
      * `blobs_url`: string
      * `git_tags_url`: string
      * `git_refs_url`: string
      * `trees_url`: string
      * `statuses_url`: string
      * `languages_url`: string
      * `stargazers_url`: string
      * `contributors_url`: string
      * `subscribers_url`: string
      * `subscription_url`: string
      * `commits_url`: string
      * `git_commits_url`: string
      * `comments_url`: string
      * `issue_comment_url`: string
      * `contents_url`: string
      * `compare_url`: string
      * `merges_url`: string
      * `archive_url`: string
      * `downloads_url`: string
      * `issues_url`: string
      * `pulls_url`: string
      * `milestones_url`: string
      * `notifications_url`: string
      * `labels_url`: string
      * `releases_url`: string
      * `deployments_url`: string
      * `created_at`: string or null, format: date-time
      * `updated_at`: string or null, format: date-time
      * `pushed_at`: string or null, format: date-time
      * `git_url`: string
      * `ssh_url`: string
      * `clone_url`: string
      * `svn_url`: string
      * `homepage`: string or null
      * `size`: integer
      * `stargazers_count`: integer
      * `watchers_count`: integer
      * `language`: string or null
      * `has_issues`: boolean
      * `has_projects`: boolean
      * `has_downloads`: boolean
      * `has_wiki`: boolean
      * `has_pages`: boolean
      * `has_discussions`: boolean
      * `has_pull_requests`: boolean
      * `pull_request_creation_policy`: string, enum: `all`, `collaborators_only`
      * `forks_count`: integer
      * `mirror_url`: string or null
      * `archived`: boolean
      * `disabled`: boolean
      * `open_issues_count`: integer
      * `license`: any of:
        * **null**
        * **License Simple**
          * `key`: required, string
          * `name`: required, string
          * `url`: required, string or null, format: uri
          * `spdx_id`: required, string or null
          * `node_id`: required, string
          * `html_url`: string, format: uri
      * `allow_forking`: boolean
      * `is_template`: boolean
      * `web_commit_signoff_required`: boolean
      * `topics`: array of string
      * `visibility`: string
      * `forks`: integer
      * `open_issues`: integer
      * `watchers`: integer
      * `default_branch`: string
      * `public`: boolean
  * **GollumEvent**
    * `pages`: required, array of objects:
      * `page_name`: string or null
      * `title`: string or null
      * `summary`: string or null
      * `action`: string
      * `sha`: string
      * `html_url`: string
  * **MemberEvent**
    * `action`: required, string
    * `member`: required, `Simple User` (see above)
  * **PublicEvent**
  * **PushEvent**
    * `repository_id`: required, integer
    * `push_id`: required, integer
    * `ref`: required, string
    * `head`: required, string
    * `before`: required, string
    * `size`: integer
    * `distinct_size`: integer
    * `commits`: array of objects:
      * `sha`: string
      * `message`: string
      * `author`: object:
        * `name`: string
        * `email`: string
      * `url`: string, format: uri
      * `distinct`: boolean
  * **PullRequestEvent**
    * `action`: required, string
    * `number`: required, integer
    * `pull_request`: required, `Pull Request`:
      * `url`: required, string, format: uri
      * `id`: required, integer, format: int64
      * `node_id`: required, string
      * `html_url`: required, string, format: uri
      * `diff_url`: required, string, format: uri
      * `patch_url`: required, string, format: uri
      * `issue_url`: required, string, format: uri
      * `commits_url`: required, string, format: uri
      * `review_comments_url`: required, string, format: uri
      * `review_comment_url`: required, string
      * `comments_url`: required, string, format: uri
      * `statuses_url`: required, string, format: uri
      * `number`: required, integer
      * `state`: required, string, enum: `open`, `closed`
      * `locked`: required, boolean
      * `title`: required, string
      * `user`: required, `Simple User` (see above)
      * `body`: required, string or null
      * `labels`: required, array of objects:
        * `id`: required, integer, format: int64
        * `node_id`: required, string
        * `url`: required, string
        * `name`: required, string
        * `description`: required, string or null
        * `color`: required, string
        * `default`: required, boolean
      * `milestone`: required, any of:
        * **null**
        * **Milestone** (see above)
      * `active_lock_reason`: string or null
      * `created_at`: required, string, format: date-time
      * `updated_at`: required, string, format: date-time
      * `closed_at`: required, string or null, format: date-time
      * `merged_at`: required, string or null, format: date-time
      * `assignees`: array of `Simple User` (see above)
      * `requested_reviewers`: array of `Simple User` (see above)
      * `requested_teams`: array of `Team Simple`:
        * `id`: required, integer
        * `node_id`: required, string
        * `url`: required, string, format: uri
        * `members_url`: required, string
        * `name`: required, string
        * `description`: required, string or null
        * `permission`: required, string
        * `privacy`: string
        * `notification_setting`: string
        * `html_url`: required, string, format: uri
        * `repositories_url`: required, string, format: uri
        * `slug`: required, string
        * `ldap_dn`: string
        * `type`: required, string, enum: `enterprise`, `organization`
        * `organization_id`: integer
        * `enterprise_id`: integer
      * `head`: required, object:
        * `label`: required, string
        * `ref`: required, string
        * `repo`: required, object
        * `sha`: required, string
        * `user`: required, object
      * `base`: required, object:
        * `label`: required, string
        * `ref`: required, string
        * `repo`: required, object
        * `sha`: required, string
        * `user`: required, object
      * `_links`: required, object:
        * `comments`: required, object
        * `commits`: required, object
        * `statuses`: required, object
        * `html`: required, object
        * `issue`: required, object
        * `review_comments`: required, object
        * `review_comment`: required, object
        * `self`: required, object
      * `author_association`: required, string, enum: `COLLABORATOR`, `CONTRIBUTOR`, `FIRST_TIMER`, `FIRST_TIME_CONTRIBUTOR`, `MANNEQUIN`, `MEMBER`, `NONE`, `OWNER`
      * `auto_merge`: required, `Auto merge`:
        * `enabled_by`: required, object
        * `merge_method`: required, string, enum: `merge`, `squash`, `rebase`
        * `commit_title`: required, string
        * `commit_message`: required, string
      * `stack`: `Pull Request Stack`:
        * `base`: required, object
        * `size`: integer
        * `position`: integer
        * `id`: integer
        * `number`: integer
      * `draft`: boolean
      * `merged`: required, boolean
      * `mergeable`: required, boolean or null
      * `rebaseable`: boolean or null
      * `mergeable_state`: required, string
      * `merged_by`: required, any of:
        * **null**
        * **Simple User** (see above)
      * `comments`: required, integer
      * `review_comments`: required, integer
      * `maintainer_can_modify`: required, boolean
      * `commits`: required, integer
      * `additions`: required, integer
      * `deletions`: required, integer
      * `changed_files`: required, integer
    * `assignee`: `Simple User` (see above)
    * `assignees`: array of `Simple User` (see above)
    * `label`: `Label` (see above)
    * `labels`: array of `Label` (see above)
  * **PullRequestReviewCommentEvent**
    * `action`: required, string
    * `pull_request`: required, `Pull Request` (see above)
    * `comment`: required, object:
      * `id`: required, integer
      * `node_id`: required, string
      * `url`: required, string, format: uri
      * `pull_request_review_id`: required, integer or null
      * `diff_hunk`: required, string
      * `path`: required, string
      * `position`: required, integer or null
      * `original_position`: required, integer or null
      * `subject_type`: string or null
      * `commit_id`: required, string
      * `user`: required, `User`:
        * `avatar_url`: string, format: uri
        * `deleted`: boolean
        * `email`: string or null
        * `events_url`: string, format: uri-template
        * `followers_url`: string, format: uri
        * `following_url`: string, format: uri-template
        * `gists_url`: string, format: uri-template
        * `gravatar_id`: string
        * `html_url`: string, format: uri
        * `id`: integer, format: int64
        * `login`: string
        * `name`: string
        * `node_id`: string
        * `organizations_url`: string, format: uri
        * `received_events_url`: string, format: uri
        * `repos_url`: string, format: uri
        * `site_admin`: boolean
        * `starred_url`: string, format: uri-template
        * `subscriptions_url`: string, format: uri
        * `type`: string, enum: `Bot`, `User`, `Organization`
        * `url`: string, format: uri
        * `user_view_type`: string
      * `body`: required, string
      * `created_at`: required, string, format: date-time
      * `updated_at`: required, string, format: date-time
      * `html_url`: required, string, format: uri
      * `pull_request_url`: required, string, format: uri
      * `_links`: required, object:
        * `html`: required, object
        * `pull_request`: required, object
        * `self`: required, object
      * `original_commit_id`: required, string
      * `reactions`: required, `Reactions`:
        * `+1`: integer
        * `-1`: integer
        * `confused`: integer
        * `eyes`: integer
        * `heart`: integer
        * `hooray`: integer
        * `laugh`: integer
        * `rocket`: integer
        * `total_count`: integer
        * `url`: string, format: uri
      * `in_reply_to_id`: integer
      * `author_association`: string
      * `start_line`: integer or null
      * `original_start_line`: integer or null
      * `start_side`: string or null
      * `line`: integer or null
      * `original_line`: integer or null
      * `side`: string or null
  * **PullRequestReviewEvent**
    * `action`: required, string
    * `review`: required, object:
      * `id`: integer
      * `node_id`: string
      * `user`: any of:
        * **null**
        * **Simple User** (see above)
      * `body`: string
      * `commit_id`: string
      * `submitted_at`: string or null
      * `state`: string
      * `html_url`: string, format: uri
      * `pull_request_url`: string, format: uri
      * `_links`: object:
        * `html`: required, object
        * `pull_request`: required, object
      * `updated_at`: string
      * `author_association`: string, enum: `COLLABORATOR`, `CONTRIBUTOR`, `FIRST_TIMER`, `FIRST_TIME_CONTRIBUTOR`, `MANNEQUIN`, `MEMBER`, `NONE`, `OWNER`
    * `pull_request`: required, `Pull Request` (see above)
  * **CommitCommentEvent**
    * `comment`: required, object:
      * `html_url`: string, format: uri
      * `url`: string, format: uri
      * `id`: integer
      * `node_id`: string
      * `body`: string
      * `path`: string or null
      * `position`: integer or null
      * `line`: integer or null
      * `commit_id`: string
      * `user`: any of:
        * **null**
        * **Simple User** (see above)
      * `created_at`: string, format: date-time
      * `updated_at`: string, format: date-time
      * `reactions`: `Reaction Rollup` (see above)
      * `author_association`: string, enum: `COLLABORATOR`, `CONTRIBUTOR`, `FIRST_TIMER`, `FIRST_TIME_CONTRIBUTOR`, `MANNEQUIN`, `MEMBER`, `NONE`, `OWNER`
  * **ReleaseEvent**
    * `action`: required, string
    * `release`: required, all of:
      * **Release**
        * `url`: required, string, format: uri
        * `html_url`: required, string, format: uri
        * `assets_url`: required, string, format: uri
        * `upload_url`: required, string
        * `tarball_url`: required, string or null, format: uri
        * `zipball_url`: required, string or null, format: uri
        * `id`: required, integer
        * `node_id`: required, string
        * `tag_name`: required, string
        * `target_commitish`: required, string
        * `name`: required, string or null
        * `body`: string or null
        * `draft`: required, boolean
        * `prerelease`: required, boolean
        * `immutable`: boolean
        * `created_at`: required, string, format: date-time
        * `published_at`: required, string or null, format: date-time
        * `updated_at`: string or null, format: date-time
        * `author`: required, `Simple User` (see above)
        * `assets`: required, array of `Release Asset`:
          * `url`: required, string, format: uri
          * `browser_download_url`: required, string, format: uri
          * `id`: required, integer
          * `node_id`: required, string
          * `name`: required, string
          * `label`: required, string or null
          * `state`: required, string, enum: `uploaded`, `open`
          * `content_type`: required, string
          * `size`: required, integer
          * `digest`: required, string or null
          * `download_count`: required, integer
          * `created_at`: required, string, format: date-time
          * `updated_at`: required, string, format: date-time
          * `uploader`: required, any of:
            * **null**
            * **Simple User**
        * `body_html`: string
        * `body_text`: string
        * `mentions_count`: integer
        * `reactions`: `Reaction Rollup` (see above)
      * **object**
        * `is_short_description_html_truncated`: boolean
        * `short_description_html`: string
  * **WatchEvent**
    * `action`: required, string
* `public`: required, boolean
* `created_at`: required, string or null, format: date-time

## List public events for a network of repositories

```
GET /networks/{owner}/{repo}/events
```

Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

* **301** - Moved permanently

* **304** - Not modified

* **403** - Forbidden

* **404** - Resource not found

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/networks/OWNER/REPO/events
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List public organization events

```
GET /orgs/{org}/events
```

Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`org`** (string) (required)
  The organization name. The name is not case sensitive.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/orgs/ORG/events
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List repository events

```
GET /repos/{owner}/{repo}/events
```

Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/events
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List events for the authenticated user

```
GET /users/{username}/events
```

If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events. Optional: use the fine-grained token with following permission set to view private events: "Events" user permissions (read).
Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`username`** (string) (required)
  The handle for the GitHub user account.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/users/USERNAME/events
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List organization events for the authenticated user

```
GET /users/{username}/events/orgs/{org}
```

This is the user's organization dashboard. You must be authenticated as the user to view this.
Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`username`** (string) (required)
  The handle for the GitHub user account.

* **`org`** (string) (required)
  The organization name. The name is not case sensitive.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/users/USERNAME/events/orgs/ORG
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List public events for a user

```
GET /users/{username}/events/public
```

Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`username`** (string) (required)
  The handle for the GitHub user account.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/users/USERNAME/events/public
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List events received by the authenticated user

```
GET /users/{username}/received_events
```

These are events that you've received by watching repositories and following users. If you are authenticated as the
given user, you will see private events. Otherwise, you'll only see public events.
Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`username`** (string) (required)
  The handle for the GitHub user account.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/users/USERNAME/received_events
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).

## List public events received by a user

```
GET /users/{username}/received_events/public
```

Note

This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`username`** (string) (required)
  The handle for the GitHub user account.

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/users/USERNAME/received_events/public
```

**Response schema (Status: 200):**

Same response schema as [List public events](#list-public-events).