List check suites for a Git reference

GET {{baseUrl}}/repos/:owner/:repo/commits/:ref/check-suites?app_id=<integer>&check_name=<string>&per_page=30&page=1

Note: The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull_requests array and a null value for head_branch.

Lists check suites for a commit ref. The ref can be a SHA, branch name, or a tag name. GitHub Apps must have the checks:read permission on a private repository or pull access to a public repository to list check suites. OAuth Apps and authenticated users must have the repo scope to get check suites in a private repository.

Request Params

KeyDatatypeRequiredDescription
app_idstringFilters check suites by GitHub App id.
check_namestringReturns check runs with the specified name.
per_pagenumberResults per page (max 100)
pagenumberPage number of the results to fetch.

RESPONSES

status: OK

{&quot;total_count&quot;:1,&quot;check_suites&quot;:[{&quot;id&quot;:5,&quot;node_id&quot;:&quot;MDEwOkNoZWNrU3VpdGU1&quot;,&quot;head_branch&quot;:&quot;master&quot;,&quot;head_sha&quot;:&quot;d6fde92930d4715a2b49857d24b940956b26d2d3&quot;,&quot;status&quot;:&quot;completed&quot;,&quot;conclusion&quot;:&quot;neutral&quot;,&quot;url&quot;:&quot;https://api.github.com/repos/github/hello-world/check-suites/5&quot;,&quot;before&quot;:&quot;146e867f55c26428e5f9fade55a9bbf5e95a7912&quot;,&quot;after&quot;:&quot;d6fde92930d4715a2b49857d24b940956b26d2d3&quot;,&quot;pull_requests&quot;:[],&quot;app&quot;:{&quot;id&quot;:1,&quot;slug&quot;:&quot;octoapp&quot;,&quot;node_id&quot;:&quot;MDExOkludGVncmF0aW9uMQ==&quot;,&quot;owner&quot;:{&quot;login&quot;:&quot;github&quot;,&quot;id&quot;:1,&quot;node_id&quot;:&quot;MDEyOk9yZ2FuaXphdGlvbjE=&quot;,&quot;url&quot;:&quot;https://api.github.com/orgs/github&quot;,&quot;repos_url&quot;:&quot;https://api.github.com/orgs/github/repos&quot;,&quot;events_url&quot;:&quot;https://api.github.com/orgs/github/events&quot;,&quot;avatar_url&quot;:&quot;https://github.com/images/error/octocat_happy.gif&quot;,&quot;gravatar_id&quot;:&quot;&quot;,&quot;html_url&quot;:&quot;https://github.com/octocat&quot;,&quot;followers_url&quot;:&quot;https://api.github.com/users/octocat/followers&quot;,&quot;following_url&quot;:&quot;https://api.github.com/users/octocat/following{/other_user}&quot;,&quot;gists_url&quot;:&quot;https://api.github.com/users/octocat/gists{/gist_id}&quot;,&quot;starred_url&quot;:&quot;https://api.github.com/users/octocat/starred{/owner}{/repo}&quot;,&quot;subscriptions_url&quot;:&quot;https://api.github.com/users/octocat/subscriptions&quot;,&quot;organizations_url&quot;:&quot;https://api.github.com/users/octocat/orgs&quot;,&quot;received_events_url&quot;:&quot;https://api.github.com/users/octocat/received_events&quot;,&quot;type&quot;:&quot;User&quot;,&quot;site_admin&quot;:true},&quot;name&quot;:&quot;Octocat App&quot;,&quot;description&quot;:&quot;&quot;,&quot;external_url&quot;:&quot;https://example.com&quot;,&quot;html_url&quot;:&quot;https://github.com/apps/octoapp&quot;,&quot;created_at&quot;:&quot;2017-07-08T16:18:44-04:00&quot;,&quot;updated_at&quot;:&quot;2017-07-08T16:18:44-04:00&quot;,&quot;permissions&quot;:{&quot;metadata&quot;:&quot;read&quot;,&quot;contents&quot;:&quot;read&quot;,&quot;issues&quot;:&quot;write&quot;,&quot;single_file&quot;:&quot;write&quot;},&quot;events&quot;:[&quot;push&quot;,&quot;pull_request&quot;]},&quot;repository&quot;:{&quot;id&quot;:1296269,&quot;node_id&quot;:&quot;MDEwOlJlcG9zaXRvcnkxMjk2MjY5&quot;,&quot;name&quot;:&quot;Hello-World&quot;,&quot;full_name&quot;:&quot;octocat/Hello-World&quot;,&quot;owner&quot;:{&quot;login&quot;:&quot;octocat&quot;,&quot;id&quot;:1,&quot;node_id&quot;:&quot;MDQ6VXNlcjE=&quot;,&quot;avatar_url&quot;:&quot;https://github.com/images/error/octocat_happy.gif&quot;,&quot;gravatar_id&quot;:&quot;&quot;,&quot;url&quot;:&quot;https://api.github.com/users/octocat&quot;,&quot;html_url&quot;:&quot;https://github.com/octocat&quot;,&quot;followers_url&quot;:&quot;https://api.github.com/users/octocat/followers&quot;,&quot;following_url&quot;:&quot;https://api.github.com/users/octocat/following{/other_user}&quot;,&quot;gists_url&quot;:&quot;https://api.github.com/users/octocat/gists{/gist_id}&quot;,&quot;starred_url&quot;:&quot;https://api.github.com/users/octocat/starred{/owner}{/repo}&quot;,&quot;subscriptions_url&quot;:&quot;https://api.github.com/users/octocat/subscriptions&quot;,&quot;organizations_url&quot;:&quot;https://api.github.com/users/octocat/orgs&quot;,&quot;repos_url&quot;:&quot;https://api.github.com/users/octocat/repos&quot;,&quot;events_url&quot;:&quot;https://api.github.com/users/octocat/events{/privacy}&quot;,&quot;received_events_url&quot;:&quot;https://api.github.com/users/octocat/received_events&quot;,&quot;type&quot;:&quot;User&quot;,&quot;site_admin&quot;:false},&quot;private&quot;:false,&quot;html_url&quot;:&quot;https://github.com/octocat/Hello-World&quot;,&quot;description&quot;:&quot;This your first repo!&quot;,&quot;fork&quot;:false,&quot;url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World&quot;,&quot;archive_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}&quot;,&quot;assignees_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/assignees{/user}&quot;,&quot;blobs_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}&quot;,&quot;branches_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/branches{/branch}&quot;,&quot;collaborators_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}&quot;,&quot;comments_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/comments{/number}&quot;,&quot;commits_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/commits{/sha}&quot;,&quot;compare_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}&quot;,&quot;contents_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/contents/{+path}&quot;,&quot;contributors_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/contributors&quot;,&quot;deployments_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/deployments&quot;,&quot;downloads_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/downloads&quot;,&quot;events_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/events&quot;,&quot;forks_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/forks&quot;,&quot;git_commits_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}&quot;,&quot;git_refs_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}&quot;,&quot;git_tags_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}&quot;,&quot;git_url&quot;:&quot;git:github.com/octocat/Hello-World.git&quot;,&quot;issue_comment_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}&quot;,&quot;issue_events_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/issues/events{/number}&quot;,&quot;issues_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/issues{/number}&quot;,&quot;keys_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/keys{/key_id}&quot;,&quot;labels_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/labels{/name}&quot;,&quot;languages_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/languages&quot;,&quot;merges_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/merges&quot;,&quot;milestones_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/milestones{/number}&quot;,&quot;notifications_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}&quot;,&quot;pulls_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/pulls{/number}&quot;,&quot;releases_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/releases{/id}&quot;,&quot;ssh_url&quot;:&quot;git@github.com:octocat/Hello-World.git&quot;,&quot;stargazers_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/stargazers&quot;,&quot;statuses_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/statuses/{sha}&quot;,&quot;subscribers_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/subscribers&quot;,&quot;subscription_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/subscription&quot;,&quot;tags_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/tags&quot;,&quot;teams_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/teams&quot;,&quot;trees_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}&quot;,&quot;clone_url&quot;:&quot;https://github.com/octocat/Hello-World.git&quot;,&quot;mirror_url&quot;:&quot;git:git.example.com/octocat/Hello-World&quot;,&quot;hooks_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/hooks&quot;,&quot;svn_url&quot;:&quot;https://svn.github.com/octocat/Hello-World&quot;,&quot;homepage&quot;:&quot;https://github.com&quot;,&quot;language&quot;:null,&quot;forks_count&quot;:9,&quot;stargazers_count&quot;:80,&quot;watchers_count&quot;:80,&quot;size&quot;:108,&quot;default_branch&quot;:&quot;master&quot;,&quot;open_issues_count&quot;:0,&quot;is_template&quot;:true,&quot;topics&quot;:[&quot;octocat&quot;,&quot;atom&quot;,&quot;electron&quot;,&quot;api&quot;],&quot;has_issues&quot;:true,&quot;has_projects&quot;:true,&quot;has_wiki&quot;:true,&quot;has_pages&quot;:false,&quot;has_downloads&quot;:true,&quot;archived&quot;:false,&quot;disabled&quot;:false,&quot;visibility&quot;:&quot;public&quot;,&quot;pushed_at&quot;:&quot;2011-01-26T19:06:43Z&quot;,&quot;created_at&quot;:&quot;2011-01-26T19:01:12Z&quot;,&quot;updated_at&quot;:&quot;2011-01-26T19:14:43Z&quot;,&quot;permissions&quot;:{&quot;admin&quot;:false,&quot;push&quot;:false,&quot;pull&quot;:true},&quot;temp_clone_token&quot;:&quot;ABTLWHOULUVAXGTRYU7OC2876QJ2O&quot;,&quot;delete_branch_on_merge&quot;:true,&quot;subscribers_count&quot;:42,&quot;network_count&quot;:0},&quot;created_at&quot;:&quot;2011-01-26T19:01:12Z&quot;,&quot;updated_at&quot;:&quot;2011-01-26T19:14:43Z&quot;,&quot;head_commit&quot;:{&quot;id&quot;:&quot;7fd1a60b01f91b314f59955a4e4d4e80d8edf11d&quot;,&quot;tree_id&quot;:&quot;7fd1a60b01f91b314f59955a4e4d4e80d8edf11d&quot;,&quot;message&quot;:&quot;Merge pull request #6 from Spaceghost/patch-1\n\nNew line at end of file.&quot;,&quot;timestamp&quot;:&quot;2016-10-10T00:00:00Z&quot;,&quot;author&quot;:{&quot;name&quot;:&quot;The Octocat&quot;,&quot;email&quot;:&quot;octocat@nowhere.com&quot;},&quot;committer&quot;:{&quot;name&quot;:&quot;The Octocat&quot;,&quot;email&quot;:&quot;octocat@nowhere.com&quot;}},&quot;latest_check_runs_count&quot;:1,&quot;check_runs_url&quot;:&quot;https://api.github.com/repos/octocat/Hello-World/check-suites/5/check-runs&quot;}]}