List issue events for a repository
Lists events for a repository.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”The account owner of the repository. The name is not case sensitive.
The name of the repository without the .git extension. The name is not case sensitive.
Query Parameters
Section titled “ Query Parameters ”The number of results per page (max 100). For more information, see “Using pagination in the REST API.”
The page number of the results to fetch. For more information, see “Using pagination in the REST API.”
Responses
Section titled “ Responses ”Response
Issue Event
object
A GitHub user.
object
Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.
object
URL for the issue
Number uniquely identifying the issue within its repository
State of the issue; either ‘open’ or ‘closed’
The reason for the current state
Title of the issue
Contents of the issue
A GitHub user.
object
Labels to associate with this issue; pass one or more label names to replace the set of labels on this issue; send an empty array to clear all labels from the issue; note that the labels are silently dropped for users without push access to the repository
object
A GitHub user.
object
A GitHub user.
object
A collection of related issues and pull requests.
object
The number of the milestone.
The state of the milestone.
The title of the milestone.
A GitHub user.
object
object
A GitHub user.
object
The type assigned to the issue. This is only present for issues in repositories where issue types are supported.
object
The unique identifier of the issue type.
The node identifier of the issue type.
The name of the issue type.
The description of the issue type.
The color of the issue type.
The time the issue type created.
The time the issue type last updated.
The enabled state of the issue type.
A repository on GitHub.
object
Unique identifier of the repository
The name of the repository.
License Simple
object
object
A GitHub user.
object
Whether the repository is private or public.
The size of the repository, in kilobytes. Size is calculated hourly. When a repository is initially created, the size is 0.
The default branch of the repository.
Whether this repository acts as a template that can be used to generate new repositories.
Whether issues are enabled.
Whether projects are enabled.
Whether the wiki is enabled.
Whether downloads are enabled.
Whether discussions are enabled.
Whether pull requests are enabled.
The policy controlling who can create pull requests: all or collaborators_only.
Whether the repository is archived.
Returns whether or not this repository disabled.
The repository visibility: public, private, or internal.
Whether to allow rebase merges for pull requests.
Whether to allow squash merges for pull requests.
Whether to allow Auto-merge to be used on pull requests.
Whether to delete head branches when pull requests are merged
Whether or not a pull request head branch that is behind its base branch can always be updated even if it is not required to be up to date before merging.
Whether a squash merge commit can use the pull request title as default. **This property is closing down. Please use squash_merge_commit_title instead.
The default value for a squash merge commit title:
PR_TITLE- default to the pull request’s title.COMMIT_OR_PR_TITLE- default to the commit’s title (if only one commit) or the pull request’s title (when more than one commit).
The default value for a squash merge commit message:
PR_BODY- default to the pull request’s body.COMMIT_MESSAGES- default to the branch’s commit messages.BLANK- default to a blank commit message.
The default value for a merge commit title.
PR_TITLE- default to the pull request’s title.MERGE_MESSAGE- default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name).
The default value for a merge commit message.
PR_TITLE- default to the pull request’s title.PR_BODY- default to the pull request’s body.BLANK- default to a blank commit message.
Whether to allow merge commits for pull requests.
Whether to allow forking this repo
Whether to require contributors to sign off on web-based commits
Whether anonymous git access is enabled for this repository
The status of the code search index for this repository
object
GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.
object
Unique identifier of the GitHub app
The slug name of the GitHub app
A GitHub user.
object
An enterprise on GitHub.
object
A short description of the enterprise.
The enterprise’s website URL.
Unique identifier of the enterprise
The name of the enterprise.
The slug url identifier for the enterprise.
The name of the GitHub app
The set of permissions for the GitHub app
object
The list of events for the GitHub app. Note that the installation_target, security_advisory, and meta events are not included because they are global events and not specific to an installation.
The number of installations associated with the GitHub app. Only returned when the integration is requesting details about itself.
How the author is associated with the repository.
object
object
URL to get the parent issue of this issue, if it is a sub-issue
Comments provide a way for people to collaborate on an issue.
object
Unique identifier of the issue comment
URL for the issue comment
Contents of the issue comment
A GitHub user.
object
How the author is associated with the repository.
GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.
object
Unique identifier of the GitHub app
The slug name of the GitHub app
A GitHub user.
object
An enterprise on GitHub.
object
A short description of the enterprise.
The enterprise’s website URL.
Unique identifier of the enterprise
The name of the enterprise.
The slug url identifier for the enterprise.
The name of the GitHub app
The set of permissions for the GitHub app
object
The list of events for the GitHub app. Note that the installation_target, security_advisory, and meta events are not included because they are global events and not specific to an installation.
The number of installations associated with the GitHub app. Only returned when the integration is requesting details about itself.
object
Context around who pinned an issue comment and when it was pinned.
object
A GitHub user.
object
Details about why an issue comment was minimized.
object
The reason the comment was minimized.
object
A value assigned to an issue field
object
Unique identifier for the issue field.
The human-readable name of the issue field.
The data type of the issue field
Details about the selected option (only present for single_select fields)
object
Unique identifier for the option.
The name of the option
The color of the option
Details about the selected options
object
Unique identifier for the option.
The name of the option
The color of the option
Issue Event Label
object
A GitHub user.
object
A GitHub user.
object
A GitHub user.
object
A GitHub user.
object
Groups of organization members that gives permissions on specified repositories.
object
object
The ownership type of the team
How the team’s access to the repository was granted. This property is only
present when the team is returned in a repository context, such as
GET /repos/{owner}/{repo}/teams.
Unique identifier of the organization to which this team belongs
Unique identifier of the enterprise to which this team belongs
Groups of organization members that gives permissions on specified repositories.
object
Unique identifier of the team
URL for the team
Name of the team
Description of the team
Permission that the team will have for its repositories
The level of privacy this team should have
The notification setting the team has set
Distinguished Name (DN) that team maps to within LDAP environment
The ownership type of the team
Unique identifier of the organization to which this team belongs
Unique identifier of the enterprise to which this team belongs
object
Issue Event Milestone
object
Issue Event Project Card
object
Issue Event Rename
object
The type of issue.
object
The unique identifier of the issue type.
The name of the issue type.
The color of the issue type.
The type of issue.
object
The unique identifier of the issue type.
The name of the issue type.
The color of the issue type.
A minimal reference to an issue linked from a timeline event (e.g. sub-issue, parent-issue, or dependency events).
object
The number of the referenced issue.
The title of the referenced issue.
The state of the referenced issue.
The reason for the referenced issue’s state.
A GitHub repository.
object
A unique identifier of the repository.
The GraphQL identifier of the repository.
The name of the repository.
The full, globally unique, name of the repository.
A GitHub user.
object
Whether the repository is private.
The URL to view the repository on GitHub.com.
The repository description.
Whether the repository is a fork.
The URL to get more information about the repository from the GitHub API.
A template for the API URL to download the repository as an archive.
A template for the API URL to list the available assignees for issues in the repository.
A template for the API URL to create or retrieve a raw Git blob in the repository.
A template for the API URL to get information about branches in the repository.
A template for the API URL to get information about collaborators of the repository.
A template for the API URL to get information about comments on the repository.
A template for the API URL to get information about commits on the repository.
A template for the API URL to compare two commits or refs.
A template for the API URL to get the contents of the repository.
A template for the API URL to list the contributors to the repository.
The API URL to list the deployments of the repository.
The API URL to list the downloads on the repository.
The API URL to list the events of the repository.
The API URL to list the forks of the repository.
A template for the API URL to get information about Git commits of the repository.
A template for the API URL to get information about Git refs of the repository.
A template for the API URL to get information about Git tags of the repository.
A template for the API URL to get information about issue comments on the repository.
A template for the API URL to get information about issue events on the repository.
A template for the API URL to get information about issues on the repository.
A template for the API URL to get information about deploy keys on the repository.
A template for the API URL to get information about labels of the repository.
The API URL to get information about the languages of the repository.
The API URL to merge branches in the repository.
A template for the API URL to get information about milestones of the repository.
A template for the API URL to get information about notifications on the repository.
A template for the API URL to get information about pull requests on the repository.
A template for the API URL to get information about releases on the repository.
The API URL to list the stargazers on the repository.
A template for the API URL to get information about statuses of a commit.
The API URL to list the subscribers on the repository.
The API URL to subscribe to notifications for this repository.
The API URL to get information about tags on the repository.
The API URL to list the teams on the repository.
A template for the API URL to create or retrieve a raw Git tree of the repository.
The API URL to list the hooks on the repository.
The type of the referenced issue.
object
The unique identifier of the issue type.
The node identifier of the issue type.
The name of the issue type.
The color of the issue type.
A minimal reference to an issue linked from a timeline event (e.g. sub-issue, parent-issue, or dependency events).
object
The number of the referenced issue.
The title of the referenced issue.
The state of the referenced issue.
The reason for the referenced issue’s state.
A GitHub repository.
object
A unique identifier of the repository.
The GraphQL identifier of the repository.
The name of the repository.
The full, globally unique, name of the repository.
A GitHub user.
object
Whether the repository is private.
The URL to view the repository on GitHub.com.
The repository description.
Whether the repository is a fork.
The URL to get more information about the repository from the GitHub API.
A template for the API URL to download the repository as an archive.
A template for the API URL to list the available assignees for issues in the repository.
A template for the API URL to create or retrieve a raw Git blob in the repository.
A template for the API URL to get information about branches in the repository.
A template for the API URL to get information about collaborators of the repository.
A template for the API URL to get information about comments on the repository.
A template for the API URL to get information about commits on the repository.
A template for the API URL to compare two commits or refs.
A template for the API URL to get the contents of the repository.
A template for the API URL to list the contributors to the repository.
The API URL to list the deployments of the repository.
The API URL to list the downloads on the repository.
The API URL to list the events of the repository.
The API URL to list the forks of the repository.
A template for the API URL to get information about Git commits of the repository.
A template for the API URL to get information about Git refs of the repository.
A template for the API URL to get information about Git tags of the repository.
A template for the API URL to get information about issue comments on the repository.
A template for the API URL to get information about issue events on the repository.
A template for the API URL to get information about issues on the repository.
A template for the API URL to get information about deploy keys on the repository.
A template for the API URL to get information about labels of the repository.
The API URL to get information about the languages of the repository.
The API URL to merge branches in the repository.
A template for the API URL to get information about milestones of the repository.
A template for the API URL to get information about notifications on the repository.
A template for the API URL to get information about pull requests on the repository.
A template for the API URL to get information about releases on the repository.
The API URL to list the stargazers on the repository.
A template for the API URL to get information about statuses of a commit.
The API URL to list the subscribers on the repository.
The API URL to subscribe to notifications for this repository.
The API URL to get information about tags on the repository.
The API URL to list the teams on the repository.
A template for the API URL to create or retrieve a raw Git tree of the repository.
The API URL to list the hooks on the repository.
The type of the referenced issue.
object
The unique identifier of the issue type.
The node identifier of the issue type.
The name of the issue type.
The color of the issue type.
A minimal reference to an issue linked from a timeline event (e.g. sub-issue, parent-issue, or dependency events).
object
The number of the referenced issue.
The title of the referenced issue.
The state of the referenced issue.
The reason for the referenced issue’s state.
A GitHub repository.
object
A unique identifier of the repository.
The GraphQL identifier of the repository.
The name of the repository.
The full, globally unique, name of the repository.
A GitHub user.
object
Whether the repository is private.
The URL to view the repository on GitHub.com.
The repository description.
Whether the repository is a fork.
The URL to get more information about the repository from the GitHub API.
A template for the API URL to download the repository as an archive.
A template for the API URL to list the available assignees for issues in the repository.
A template for the API URL to create or retrieve a raw Git blob in the repository.
A template for the API URL to get information about branches in the repository.
A template for the API URL to get information about collaborators of the repository.
A template for the API URL to get information about comments on the repository.
A template for the API URL to get information about commits on the repository.
A template for the API URL to compare two commits or refs.
A template for the API URL to get the contents of the repository.
A template for the API URL to list the contributors to the repository.
The API URL to list the deployments of the repository.
The API URL to list the downloads on the repository.
The API URL to list the events of the repository.
The API URL to list the forks of the repository.
A template for the API URL to get information about Git commits of the repository.
A template for the API URL to get information about Git refs of the repository.
A template for the API URL to get information about Git tags of the repository.
A template for the API URL to get information about issue comments on the repository.
A template for the API URL to get information about issue events on the repository.
A template for the API URL to get information about issues on the repository.
A template for the API URL to get information about deploy keys on the repository.
A template for the API URL to get information about labels of the repository.
The API URL to get information about the languages of the repository.
The API URL to merge branches in the repository.
A template for the API URL to get information about milestones of the repository.
A template for the API URL to get information about notifications on the repository.
A template for the API URL to get information about pull requests on the repository.
A template for the API URL to get information about releases on the repository.
The API URL to list the stargazers on the repository.
A template for the API URL to get information about statuses of a commit.
The API URL to list the subscribers on the repository.
The API URL to subscribe to notifications for this repository.
The API URL to get information about tags on the repository.
The API URL to list the teams on the repository.
A template for the API URL to create or retrieve a raw Git tree of the repository.
The API URL to list the hooks on the repository.
The type of the referenced issue.
object
The unique identifier of the issue type.
The node identifier of the issue type.
The name of the issue type.
The color of the issue type.
A minimal reference to an issue linked from a timeline event (e.g. sub-issue, parent-issue, or dependency events).
object
The number of the referenced issue.
The title of the referenced issue.
The state of the referenced issue.
The reason for the referenced issue’s state.
A GitHub repository.
object
A unique identifier of the repository.
The GraphQL identifier of the repository.
The name of the repository.
The full, globally unique, name of the repository.
A GitHub user.
object
Whether the repository is private.
The URL to view the repository on GitHub.com.
The repository description.
Whether the repository is a fork.
The URL to get more information about the repository from the GitHub API.
A template for the API URL to download the repository as an archive.
A template for the API URL to list the available assignees for issues in the repository.
A template for the API URL to create or retrieve a raw Git blob in the repository.
A template for the API URL to get information about branches in the repository.
A template for the API URL to get information about collaborators of the repository.
A template for the API URL to get information about comments on the repository.
A template for the API URL to get information about commits on the repository.
A template for the API URL to compare two commits or refs.
A template for the API URL to get the contents of the repository.
A template for the API URL to list the contributors to the repository.
The API URL to list the deployments of the repository.
The API URL to list the downloads on the repository.
The API URL to list the events of the repository.
The API URL to list the forks of the repository.
A template for the API URL to get information about Git commits of the repository.
A template for the API URL to get information about Git refs of the repository.
A template for the API URL to get information about Git tags of the repository.
A template for the API URL to get information about issue comments on the repository.
A template for the API URL to get information about issue events on the repository.
A template for the API URL to get information about issues on the repository.
A template for the API URL to get information about deploy keys on the repository.
A template for the API URL to get information about labels of the repository.
The API URL to get information about the languages of the repository.
The API URL to merge branches in the repository.
A template for the API URL to get information about milestones of the repository.
A template for the API URL to get information about notifications on the repository.
A template for the API URL to get information about pull requests on the repository.
A template for the API URL to get information about releases on the repository.
The API URL to list the stargazers on the repository.
A template for the API URL to get information about statuses of a commit.
The API URL to list the subscribers on the repository.
The API URL to subscribe to notifications for this repository.
The API URL to get information about tags on the repository.
The API URL to list the teams on the repository.
A template for the API URL to create or retrieve a raw Git tree of the repository.
The API URL to list the hooks on the repository.
The type of the referenced issue.
object
The unique identifier of the issue type.
The node identifier of the issue type.
The name of the issue type.
The color of the issue type.
How the author is associated with the repository.
GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.
object
Unique identifier of the GitHub app
The slug name of the GitHub app
A GitHub user.
object
An enterprise on GitHub.
object
A short description of the enterprise.
The enterprise’s website URL.
Unique identifier of the enterprise
The name of the enterprise.
The slug url identifier for the enterprise.
The name of the GitHub app
The set of permissions for the GitHub app
object
The list of events for the GitHub app. Note that the installation_target, security_advisory, and meta events are not included because they are global events and not specific to an installation.
The number of installations associated with the GitHub app. Only returned when the integration is requesting details about itself.
Examples
[ { "id": 1, "node_id": "MDEwOklzc3VlRXZlbnQx", "url": "https://api.github.com/repos/octocat/Hello-World/issues/events/1", "actor": { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false }, "event": "closed", "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e", "commit_url": "https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e", "created_at": "2011-04-14T16:00:49Z", "issue": { "id": 1, "node_id": "MDU6SXNzdWUx", "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347", "repository_url": "https://api.github.com/repos/octocat/Hello-World", "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}", "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments", "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events", "html_url": "https://github.com/octocat/Hello-World/issues/1347", "number": 1347, "state": "open", "title": "Found a bug", "body": "I'm having a problem with this.", "user": { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false }, "pinned_comment": null, "labels": [ { "id": 208045946, "node_id": "MDU6TGFiZWwyMDgwNDU5NDY=", "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug", "name": "bug", "description": "Something isn't working", "color": "f29513", "default": true } ], "assignee": { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false }, "assignees": [ { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false } ], "milestone": { "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1", "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0", "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels", "id": 1002604, "node_id": "MDk6TWlsZXN0b25lMTAwMjYwNA==", "number": 1, "state": "open", "title": "v1.0", "description": "Tracking milestone for version 1.0", "creator": { "login": "octocat", "id": 1, "node_id": "MDQ6VXNlcjE=", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "gravatar_id": "", "url": "https://api.github.com/users/octocat", "html_url": "https://github.com/octocat", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "organizations_url": "https://api.github.com/users/octocat/orgs", "repos_url": "https://api.github.com/users/octocat/repos", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "received_events_url": "https://api.github.com/users/octocat/received_events", "type": "User", "site_admin": false }, "open_issues": 4, "closed_issues": 8, "created_at": "2011-04-10T20:09:31Z", "updated_at": "2014-03-03T18:58:10Z", "closed_at": "2013-02-12T13:22:01Z", "due_on": "2012-10-09T23:39:01Z" }, "locked": true, "active_lock_reason": "too heated", "comments": 0, "pull_request": { "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347", "html_url": "https://github.com/octocat/Hello-World/pull/1347", "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff", "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch" }, "closed_at": null, "created_at": "2011-04-22T13:33:48Z", "updated_at": "2011-04-22T13:33:48Z", "author_association": "COLLABORATOR", "state_reason": "completed" } }]Headers
Section titled “ Headers ”Example
<https://api.github.com/resource?page=2>; rel="next", <https://api.github.com/resource?page=5>; rel="last"Validation failed, or the endpoint has been spammed.
Validation Error
object
object
Example generated
{ "message": "example", "documentation_url": "example", "errors": [ { "resource": "example", "field": "example", "message": "example", "code": "example", "index": 1, "value": [ "example" ] } ]}