Use the REST API to receive events triggered by timeline activity in issues and pull requests.
You can use the REST API to view different types of events triggered by timeline activity in issues and pull requests. For more information about the specific events that you can receive, see Issue event types. To view GitHub activity outside of issues and pull requests, see GitHub event types.
You can use timeline events to display information about issues and pull requests or determine who should be notified of issue comments.
Every pull request is an issue, but not every issue is a pull request. For this reason, "shared" actions for both features, like managing assignees, labels, and milestones, are provided within the Issues endpoints.
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.
GET /repos/{owner}/{repo}/issues/{issue_number}/timeline
List all timeline events for an issue.
accept (string)application/vnd.github+json is recommended.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.
issue_number (integer) (required)
The number that identifies the issue.
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
exclude (string)
A comma-separated list of timeline event names to exclude from the response.
200 - OK
400 - Bad Request
404 - Resource not found
410 - Gone
Request:
curl -L \
-X GET \
https://api.github.com/repos/OWNER/REPO/issues/ISSUE_NUMBER/timeline
Response schema (Status: 200):
Array of Timeline Event objects: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User:
name: string or nullemail: string or nulllogin: required, stringid: required, integer, format: int64node_id: required, stringavatar_url: required, string, format: urigravatar_id: required, string or nullurl: required, string, format: urihtml_url: required, string, format: urifollowers_url: required, string, format: urifollowing_url: required, stringgists_url: required, stringstarred_url: required, stringsubscriptions_url: required, string, format: uriorganizations_url: required, string, format: urirepos_url: required, string, format: urievents_url: required, stringreceived_events_url: required, string, format: uritype: required, stringsite_admin: required, booleanstarred_at: stringuser_view_type: stringevent: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
id: required, integerslug: stringnode_id: required, stringclient_id: stringowner: required, one of:
description: string or nullhtml_url: required, string, format: uriwebsite_url: string or null, format: uriid: required, integernode_id: required, stringname: required, stringslug: required, stringcreated_at: required, string or null, format: date-timeupdated_at: required, string or null, format: date-timeavatar_url: required, string, format: uriname: required, stringdescription: required, string or nullexternal_url: required, string, format: urihtml_url: required, string, format: uricreated_at: required, string, format: date-timeupdated_at: required, string, format: date-timepermissions: required, object, additional properties: string:
issues: stringchecks: stringmetadata: stringcontents: stringdeployments: stringevents: required, array of stringinstallations_count: integerlabel: required, object:
name: required, stringcolor: required, stringintent: any of:
rationale: string or nullconfidence: string or null, enum: LOW, MEDIUM, HIGH, nullid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
label: required, object:
name: required, stringcolor: required, stringintent: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
milestone: required, object:
title: required, stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
milestone: required, object:
title: required, stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
rename: required, object:
from: required, stringto: required, stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
review_requester: required, Simple User (see above)requested_team: Team:
id: required, integernode_id: required, stringname: required, stringslug: required, stringdescription: required, string or nullprivacy: stringnotification_setting: stringpermission: required, stringpermissions: object:
pull: required, booleantriage: required, booleanpush: required, booleanmaintain: required, booleanadmin: required, booleanurl: required, string, format: urihtml_url: required, string, format: urimembers_url: required, stringrepositories_url: required, string, format: uritype: required, string, enum: enterprise, organizationaccess_source: string, enum: direct, organization, enterpriseorganization_id: integerenterprise_id: integerparent: required, any of:
id: required, integernode_id: required, stringurl: required, string, format: urimembers_url: required, stringname: required, stringdescription: required, string or nullpermission: required, stringprivacy: stringnotification_setting: stringhtml_url: required, string, format: urirepositories_url: required, string, format: urislug: required, stringldap_dn: stringtype: required, string, enum: enterprise, organizationorganization_id: integerenterprise_id: integerrequested_reviewer: Simple User (see above)id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
review_requester: required, Simple User (see above)requested_team: Team (see above)requested_reviewer: Simple User (see above)id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
dismissed_review: required, object:
state: required, stringreview_id: required, integerdismissal_message: required, string or nulldismissal_commit_id: stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
lock_reason: required, string or nullid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
project_card: object:
id: required, integerurl: required, string, format: uriproject_id: required, integerproject_url: required, string, format: uricolumn_name: required, stringprevious_column_name: stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
project_card: object:
id: required, integerurl: required, string, format: uriproject_id: required, integerproject_url: required, string, format: uricolumn_name: required, stringprevious_column_name: stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
project_card: object:
id: required, integerurl: required, string, format: uriproject_id: required, integerproject_url: required, string, format: uricolumn_name: required, stringprevious_column_name: stringid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, GitHub app (see above)project_card: object:
id: required, integerurl: required, string, format: uriproject_id: required, integerproject_url: required, string, format: uricolumn_name: required, stringprevious_column_name: stringevent: required, stringactor: required, Simple User (see above)id: required, integernode_id: required, stringurl: required, string, format: uribody: stringbody_text: stringbody_html: stringhtml_url: required, string, format: uriuser: required, Simple User (see above)created_at: required, string, format: date-timeupdated_at: required, string, format: date-timeissue_url: required, string, format: uriauthor_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNERperformed_via_github_app: any of:
reactions: Reaction Rollup:
url: required, string, format: uritotal_count: required, integer+1: required, integer-1: required, integerlaugh: required, integerconfused: required, integerheart: required, integerhooray: required, integereyes: required, integerrocket: required, integerpin: any of:
pinned_at: required, string, format: date-timepinned_by: required, any of:
minimized: any of:
reason: required, string or nullevent: required, stringactor: Simple User (see above)created_at: required, string, format: date-timeupdated_at: required, string, format: date-timesource: required, object:
type: stringissue: Issue:
id: required, integer, format: int64node_id: required, stringurl: required, string, format: urirepository_url: required, string, format: urilabels_url: required, stringcomments_url: required, string, format: urievents_url: required, string, format: urihtml_url: required, string, format: urinumber: required, integerstate: required, stringstate_reason: string or null, enum: completed, reopened, not_planned, duplicate, nulltitle: required, stringbody: string or nulluser: required, any of:
labels: required, array of items:
id: integer, format: int64node_id: stringurl: string, format: uriname: stringdescription: string or nullcolor: string or nulldefault: booleanarchived_by: all of:
assignees: array of Simple User (see above)milestone: required, any of:
url: required, string, format: urihtml_url: required, string, format: urilabels_url: required, string, format: uriid: required, integernode_id: required, stringnumber: required, integerstate: required, string, enum: open, closed, default: "open"title: required, stringdescription: required, string or nullcreator: required, any of:
open_issues: required, integerclosed_issues: required, integercreated_at: required, string, format: date-timeupdated_at: required, string, format: date-timeclosed_at: required, string or null, format: date-timedue_on: required, string or null, format: date-timelocked: required, booleanactive_lock_reason: string or nullcomments: required, integerpull_request: object:
merged_at: string or null, format: date-timediff_url: required, string or null, format: urihtml_url: required, string or null, format: uripatch_url: required, string or null, format: uriurl: required, string or null, format: uriclosed_at: required, string or null, format: date-timecreated_at: required, string, format: date-timeupdated_at: required, string, format: date-timedraft: booleanclosed_by: any of:
body_html: stringbody_text: stringtimeline_url: string, format: uritype: Issue Type:
id: required, integernode_id: required, stringname: required, stringdescription: required, string or nullcolor: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, nullcreated_at: string, format: date-timeupdated_at: string, format: date-timeis_enabled: booleanrepository: Repository:
id: required, integer, format: int64node_id: required, stringname: required, stringfull_name: required, stringlicense: required, any of:
forks: required, integerpermissions: objectowner: required, objectprivate: required, boolean, default: falsehtml_url: required, string, format: uridescription: required, string or nullfork: required, booleanurl: required, string, format: uriarchive_url: required, stringassignees_url: required, stringblobs_url: required, stringbranches_url: required, stringcollaborators_url: required, stringcomments_url: required, stringcommits_url: required, stringcompare_url: required, stringcontents_url: required, stringcontributors_url: required, string, format: urideployments_url: required, string, format: uridownloads_url: required, string, format: urievents_url: required, string, format: uriforks_url: required, string, format: urigit_commits_url: required, stringgit_refs_url: required, stringgit_tags_url: required, stringgit_url: required, stringissue_comment_url: required, stringissue_events_url: required, stringissues_url: required, stringkeys_url: required, stringlabels_url: required, stringlanguages_url: required, string, format: urimerges_url: required, string, format: urimilestones_url: required, stringnotifications_url: required, stringpulls_url: required, stringreleases_url: required, stringssh_url: required, stringstargazers_url: required, string, format: uristatuses_url: required, stringsubscribers_url: required, string, format: urisubscription_url: required, string, format: uritags_url: required, string, format: uriteams_url: required, string, format: uritrees_url: required, stringclone_url: required, stringmirror_url: required, string or null, format: urihooks_url: required, string, format: urisvn_url: required, string, format: urihomepage: required, string or null, format: urilanguage: required, string or nullforks_count: required, integerstargazers_count: required, integerwatchers_count: required, integersize: required, integerdefault_branch: required, stringopen_issues_count: required, integeris_template: boolean, default: falsetopics: array of stringhas_issues: required, boolean, default: truehas_projects: required, boolean, default: truehas_wiki: required, boolean, default: truehas_pages: required, booleanhas_discussions: boolean, default: falsehas_pull_requests: boolean, default: truepull_request_creation_policy: string, enum: all, collaborators_onlyarchived: required, boolean, default: falsedisabled: required, booleanvisibility: string, default: "public"pushed_at: required, string or null, format: date-timecreated_at: required, string or null, format: date-timeupdated_at: required, string or null, format: date-timeallow_rebase_merge: boolean, default: truetemp_clone_token: stringallow_squash_merge: boolean, default: trueallow_auto_merge: boolean, default: falsedelete_branch_on_merge: boolean, default: falseallow_update_branch: boolean, default: falsesquash_merge_commit_title: string, enum: PR_TITLE, COMMIT_OR_PR_TITLEsquash_merge_commit_message: string, enum: PR_BODY, COMMIT_MESSAGES, BLANKmerge_commit_title: string, enum: PR_TITLE, MERGE_MESSAGEmerge_commit_message: string, enum: PR_BODY, PR_TITLE, BLANKallow_merge_commit: boolean, default: trueallow_forking: booleanweb_commit_signoff_required: boolean, default: falseopen_issues: required, integerwatchers: required, integerstarred_at: stringanonymous_access_enabled: booleancode_search_index_status: objectperformed_via_github_app: any of:
author_association: string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNERreactions: Reaction Rollup (see above)sub_issues_summary: Sub-issues Summary:
total: required, integercompleted: required, integerpercent_completed: required, integerparent_issue_url: string or null, format: uripinned_comment: any of:
id: required, integer, format: int64node_id: required, stringurl: required, string, format: uribody: stringbody_text: stringbody_html: stringhtml_url: required, string, format: uriuser: required, any of:
created_at: required, string, format: date-timeupdated_at: required, string, format: date-timeissue_url: required, string, format: uriauthor_association: string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNERperformed_via_github_app: any of:
reactions: objectpin: any of:
minimized: any of:
issue_dependencies_summary: Issue Dependencies Summary:
blocked_by: required, integerblocking: required, integertotal_blocked_by: required, integertotal_blocking: required, integerissue_field_values: array of Issue Field Value:
issue_field_id: required, integer, format: int64issue_field_name: stringnode_id: required, stringdata_type: required, string, enum: text, single_select, multi_select, number, datevalue: required, any of:
single_select_option: object or nullmulti_select_options: array of object or nullevent: stringsha: required, stringnode_id: required, stringurl: required, string, format: uriauthor: required, object:
date: required, string, format: date-timeemail: required, stringname: required, stringcommitter: required, object:
date: required, string, format: date-timeemail: required, stringname: required, stringmessage: required, stringtree: required, object:
sha: required, stringurl: required, string, format: uriparents: required, array of objects:
sha: required, stringurl: required, string, format: urihtml_url: required, string, format: uriverification: required, object:
verified: required, booleanreason: required, stringsignature: required, string or nullpayload: required, string or nullverified_at: required, string or nullhtml_url: required, string, format: urievent: required, stringid: required, integernode_id: required, stringuser: required, Simple User (see above)body: required, string or nullstate: required, stringhtml_url: required, string, format: uripull_request_url: required, string, format: uri_links: required, object:
html: required, object:
href: required, stringpull_request: required, object:
href: required, stringsubmitted_at: string, format: date-timeupdated_at: string or null, format: date-timecommit_id: required, stringbody_html: stringbody_text: stringauthor_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNERevent: stringnode_id: stringcomments: array of Pull Request Review Comment:
url: required, stringpull_request_review_id: required, integer or null, format: int64id: required, integer, format: int64node_id: required, stringdiff_hunk: required, stringpath: required, stringposition: integeroriginal_position: integercommit_id: required, stringoriginal_commit_id: required, stringin_reply_to_id: integeruser: required, any of:
body: required, stringcreated_at: required, string, format: date-timeupdated_at: required, string, format: date-timehtml_url: required, string, format: uripull_request_url: required, string, format: uriauthor_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER_links: required, object:
self: required, object:
href: required, string, format: urihtml: required, object:
href: required, string, format: uripull_request: required, object:
href: required, string, format: uristart_line: integer or nulloriginal_start_line: integer or nullstart_side: string or null, enum: LEFT, RIGHT, null, default: "RIGHT"line: integeroriginal_line: integerside: string, enum: LEFT, RIGHT, default: "RIGHT"subject_type: string, enum: line, filereactions: Reaction Rollup (see above)body_html: stringbody_text: stringevent: stringnode_id: stringcommit_id: stringcomments: array of Commit Comment:
html_url: required, string, format: uriurl: required, string, format: uriid: required, integernode_id: required, stringbody: required, stringpath: required, string or nullposition: required, integer or nullline: required, integer or nullcommit_id: required, stringuser: required, any of:
created_at: required, string, format: date-timeupdated_at: required, string, format: date-timeauthor_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNERreactions: Reaction Rollup (see above)id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
assignee: required, Simple User (see above)intent: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
assignee: required, Simple User (see above)id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
state_reason: string or nullintent: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
issue_type: required, Issue Type:
id: required, integername: required, stringcolor: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, nullintent: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
prev_issue_type: required, Issue Type:
id: required, integername: required, stringcolor: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, nullintent: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
issue_type: required, Issue Type:
id: required, integername: required, stringcolor: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, nullprev_issue_type: required, Issue Type:
id: required, integername: required, stringcolor: string or null, enum: gray, blue, green, yellow, orange, red, pink, purple, nullintent: any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
sub_issue: required, any of:
number: required, integertitle: required, stringstate: required, stringstate_reason: string or nullrepository: required, Simple Repository:
id: required, integer, format: int64node_id: required, stringname: required, stringfull_name: required, stringowner: required, Simple User (see above)private: required, booleanhtml_url: required, string, format: uridescription: required, string or nullfork: required, booleanurl: required, string, format: uriarchive_url: required, stringassignees_url: required, stringblobs_url: required, stringbranches_url: required, stringcollaborators_url: required, stringcomments_url: required, stringcommits_url: required, stringcompare_url: required, stringcontents_url: required, stringcontributors_url: required, string, format: urideployments_url: required, string, format: uridownloads_url: required, string, format: urievents_url: required, string, format: uriforks_url: required, string, format: urigit_commits_url: required, stringgit_refs_url: required, stringgit_tags_url: required, stringissue_comment_url: required, stringissue_events_url: required, stringissues_url: required, stringkeys_url: required, stringlabels_url: required, stringlanguages_url: required, string, format: urimerges_url: required, string, format: urimilestones_url: required, stringnotifications_url: required, stringpulls_url: required, stringreleases_url: required, stringstargazers_url: required, string, format: uristatuses_url: required, stringsubscribers_url: required, string, format: urisubscription_url: required, string, format: uritags_url: required, string, format: uriteams_url: required, string, format: uritrees_url: required, stringhooks_url: required, string, format: uriissue_type: required, Issue Type:
id: required, integernode_id: required, stringname: required, stringcolor: string or nullid: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
sub_issue: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
parent_issue: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
parent_issue: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
blocked_by: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
blocked_by: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
blocking: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
blocking: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of:
id: required, integernode_id: required, stringurl: required, stringactor: required, Simple User (see above)event: required, stringcommit_id: required, string or nullcommit_url: required, string or nullcreated_at: required, stringperformed_via_github_app: required, any of: