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

Parameter	Description
Owner	The organization or person who owns the repository. github.com/{owner}/{repo}
Page	Page number of the results to fetch.
Per Page	Results per page (max 100)
Repo	Name of the repository owned by the owner. github.com/{owner}/{repo}
Return All Pages	Automatically 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

Preview this Workflow on desktop