Skip to main content

List Releases

This returns a list of releases, which does not include regular Git tags that have not been associated with a release. To get a list of Git tags, use the Repository Tags API.

Information about published releases are available to everyone. Only users with push access will receive listings for draft releases.

External Documentation

To learn more, visit the GitHub documentation.

Parameters

ParameterDescription
OwnerThe organization or person who owns the repository. github.com/{owner}/{repo}
PagePage number of the results to fetch.
Per PageResults per page (max 100)
RepoName of the repository owned by the owner. github.com/{owner}/{repo}
Return All PagesAutomatically fetch all resources, page by page.

Example Output

{
"value": [
{
"assets": [
{
"browser_download_url": "https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip",
"content_type": "application/zip",
"created_at": "2013-02-27T19:35:32Z",
"download_count": 42,
"id": 1,
"label": "short description",
"name": "example.zip",
"node_id": "MDEyOlJlbGVhc2VBc3NldDE=",
"size": 1024,
"state": "uploaded",
"updated_at": "2013-02-27T19:35:32Z",
"uploader": {
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"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}",
"gravatar_id": "",
"html_url": "https://github.com/octocat",
"id": 1,
"login": "octocat",
"node_id": "MDQ6VXNlcjE=",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"repos_url": "https://api.github.com/users/octocat/repos",
"site_admin": false,
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"type": "User",
"url": "https://api.github.com/users/octocat"
},
"url": "https://api.github.com/repos/octocat/Hello-World/releases/assets/1"
}
],
"assets_url": "https://api.github.com/repos/octocat/Hello-World/releases/1/assets",
"author": {
"avatar_url": "https://github.com/images/error/octocat_happy.gif",
"events_url": "https://api.github.com/users/octocat/events{/privacy}",
"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}",
"gravatar_id": "",
"html_url": "https://github.com/octocat",
"id": 1,
"login": "octocat",
"node_id": "MDQ6VXNlcjE=",
"organizations_url": "https://api.github.com/users/octocat/orgs",
"received_events_url": "https://api.github.com/users/octocat/received_events",
"repos_url": "https://api.github.com/users/octocat/repos",
"site_admin": false,
"starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
"type": "User",
"url": "https://api.github.com/users/octocat"
},
"body": "Description of the release",
"created_at": "2013-02-27T19:35:32Z",
"draft": false,
"html_url": "https://github.com/octocat/Hello-World/releases/v1.0.0",
"id": 1,
"name": "v1.0.0",
"node_id": "MDc6UmVsZWFzZTE=",
"prerelease": false,
"published_at": "2013-02-27T19:35:32Z",
"tag_name": "v1.0.0",
"tarball_url": "https://api.github.com/repos/octocat/Hello-World/tarball/v1.0.0",
"target_commitish": "master",
"upload_url": "https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}",
"url": "https://api.github.com/repos/octocat/Hello-World/releases/1",
"zipball_url": "https://api.github.com/repos/octocat/Hello-World/zipball/v1.0.0"
}
]
}

Workflow Library Example

List Releases with Github and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop