GET
/issuesList issues for the authenticated user
Lists issues visible to the authenticated user across owned, member, and organization repositories. Use filter, state, labels, and the sorting parameters to control participation, issue state, filtering, and ordering; responses can include both issues and pull requests. Use page and per_page to paginate the results.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
filterstringoptional
Select which issues to return: assigned, created, mentioned, subscribed, repos, or all. Defaults to assigned when omitted.
statestringoptional
Filter issues by state: open, closed, or all. Defaults to open when omitted.
labelsstringoptional
Comma-separated label names to filter issues by, such as bug, ui, or @high.
sortstringoptional
Sort results by created, updated, or comments. Defaults to created when omitted.
directionstringoptional
Sort direction: asc or desc. Defaults to desc when omitted.
sincestringoptional
Return issues updated after this ISO 8601 date-time.
collabbooleanoptional
When true, include issues from repositories where the authenticated user is a collaborator.
orgsbooleanoptional
When true, include issues from organizations.
ownedbooleanoptional
When true, include issues from repositories owned by the authenticated user.
pullsbooleanoptional
When true, include pull requests in the results.
per_pageintegeroptional
Number of results per page, up to 100. Defaults to 30 when omitted.
pageintegeroptional
Page number to retrieve. Defaults to 1 when omitted.
200Returns an array of issue objects, which can include pull requests identified by the `pull_request` field. Issue responses include identifiers, repository URLs, state, title, body, labels, and related user and milestone data.
idintegerrequired
node_idstringrequired
urlstringrequired
URL for the issue
repository_urlstringrequired
labels_urlstringrequired
comments_urlstringrequired
events_urlstringrequired
html_urlstringrequired
numberintegerrequired
Number uniquely identifying the issue within its repository
statestringrequired
State of the issue; either 'open' or 'closed'
state_reasonstringoptional
The reason for the current state
titlestringrequired
Title of the issue
bodystringoptional
Contents of the issue
userobjectrequired
A GitHub user.
labelsarray<string>required
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
assigneeobjectrequired
A GitHub user.
assigneesarray<SimpleUser>optional
milestoneobjectrequired
A collection of related issues and pull requests.
lockedbooleanrequired
active_lock_reasonstringoptional
commentsintegerrequired
pull_requestobjectoptional
closed_atstringrequired
created_atstringrequired
updated_atstringrequired
draftbooleanoptional
closed_byobjectoptional
A GitHub user.
body_htmlstringoptional
body_textstringoptional
timeline_urlstringoptional
typeobjectoptional
The type assigned to the issue. This is only present for issues in repositories where issue types are supported.
repositoryobjectoptional
A repository on GitHub.
performed_via_github_appobjectoptional
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.
author_associationstringoptional
How the author is associated with the repository.
reactionsobjectoptional
sub_issues_summaryobjectoptional
parent_issue_urlstringoptional
URL to get the parent issue of this issue, if it is a sub-issue
pinned_commentobjectoptional
Comments provide a way for people to collaborate on an issue.
issue_dependencies_summaryobjectoptional
issue_field_valuesarray<IssueFieldValue>optional
304Returns no updated representation when the requested resource has not changed.
404Returned when the requested resource cannot be found.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
422Returned when query validation fails or the endpoint has been spammed.
messagestringrequired
documentation_urlstringrequired
errorsarray<object>optional
Error handling
A 404 is returned when the requested resource cannot be found. A 422 is returned when query values fail validation or the endpoint has been spammed; use the documented values for filter, state, sort, and direction, and provide since as an ISO 8601 timestamp.