# Pontos de extremidade da API REST para eventos

Use a API REST para interagir com GitHub eventos.

## Sobre eventos GitHub

GitHub os eventos alimentam os vários fluxos de atividades no site.

Você pode usar a API REST para retornar diferentes tipos de eventos disparados pela atividade em GitHub. Para saber mais sobre os eventos específicos que podem ser recebidos, confira [tipos de evento GitHub](/pt/enterprise-server@3.22/rest/using-the-rest-api/github-event-types). Pontos de extremidade para problemas de repositório também estão disponíveis. Para saber mais, confira [Pontos de extremidade da API REST para eventos de issues](/pt/enterprise-server@3.22/rest/issues/events).

Os eventos são otimizados para sondagem a com o cabeçalho "ETag". Se nenhum novo evento for iniciado, você verá uma resposta "304 Not Modified" e seu limite de taxa atual não será alterado. Há também um cabeçalho "X-Poll-Interval" que especifica quantas vezes (em segundos) você pode fazer uma sondagem. Em tempos de alta carga do servidor, o tempo pode aumentar. Obedeça o cabeçalho.

```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
```

A linha do tempo incluirá até 300 eventos. Apenas eventos criados nos últimos 30 dias serão incluídos. Eventos mais antigos que 30 dias não serão incluídos (mesmo que o número total de eventos na linha do tempo seja inferior a 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).