# GitHub API: List releases > Lists published, non-draft releases of a public GitHub project, newest first. A bare project name matches the most-starred repository. Unofficial. Not affiliated with or endorsed by GitHub. - Page: https://fous.com/methods/github.com/list-releases - Method: `github.com/list_releases`, version 1 - Website: github.com - Returns: project details and releases with version, title, date, pre-release flag, notes, download files and page link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `project` | string | yes | `"cli/cli"` | Project name, owner/name, or GitHub repository link, such as microsoft/vscode. | | `max_results` | integer | no | `2` | Maximum number of releases to return, such as 10. Default 10. | | `include_pre_releases` | boolean | no | | Include pre-releases as well as stable releases; for example, true. Default false. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "project": "cli/cli", "max_results": 2 } ``` Its output: ```json { "project": { "name": "cli", "owner": "cli", "full_name": "cli/cli", "page_link": "https://github.com/cli/cli" }, "releases": [ { "version": "v2.103.0", "pre_release": "no", "release_date": "2026-10-21", "release_notes": "Expiring, auto-refreshing OAuth tokens (preview)\ngh can now sign in with expiring OAuth credentials that it refreshes automatically. When you opt in, gh stores a short-lived access token alongside a rotating refresh token and refreshes the access token whenever it is needed, so you stay signed in wi…", "release_title": "GitHub CLI 2.103.0", "download_files": [ { "file_name": "gh_2.103.0_checksums.txt", "download_count": 18463 }, { "file_name": "gh_2.103.0_linux_386.deb", "download_count": 109 }, { "file_name": "gh_2.103.0_linux_386.rpm", "download_count": 47 } ], "release_page_link": "https://github.com/cli/cli/releases/tag/v2.103.0" }, { "version": "v2.102.1", "pre_release": "no", "release_date": "2026-10-20", "release_notes": "What's Changed\n:dependabot: Dependencies\nchore(deps): bump Go toolchain from 1.27.1 to 1.27.3 and golang.org/x/net from 0.58.0 to 0.60.0\nFull Changelog: https://github.com/cli/cli/compare/v2.102.0...v2.102.1", "release_title": "GitHub CLI 2.102.1", "download_files": [ { "file_name": "gh_2.102.1_checksums.txt", "download_count": 11328 }, { "file_name": "gh_2.102.1_linux_386.deb", "download_count": 73 }, { "file_name": "gh_2.102.1_linux_386.rpm", "download_count": 43 } ], "release_page_link": "https://github.com/cli/cli/releases/tag/v2.102.1" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"github.com/list_releases","input":{"project":"cli/cli","max_results":2}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What are the latest stable releases of the vscode project, with version numbers and download files? - Show me the last 10 versions of microsoft/vscode including release notes and dates. - Can you list recent pre-release and stable builds of the react repository, newest first? - I need the release history for the most popular project named kubernetes, including titles and page links. - Find the newest published versions of the tensorflow/tensorflow repo on GitHub, up to 25 entries, with pre-releases included. ## Input schema ```json { "type": "object", "required": [ "project" ], "properties": { "project": { "type": "string", "minLength": 1, "description": "Project name, owner/name, or GitHub repository link, such as microsoft/vscode." }, "max_results": { "type": "integer", "default": 10, "maximum": 100, "minimum": 1, "description": "Maximum number of releases to return, such as 10." }, "include_pre_releases": { "type": "boolean", "default": false, "description": "Include pre-releases as well as stable releases; for example, true." } } } ``` ## Output schema ```json { "type": "object", "required": [ "project", "releases" ], "properties": { "project": { "type": "object", "required": [ "name", "owner", "full_name", "page_link" ], "properties": { "name": { "type": "string" }, "owner": { "type": "string" }, "full_name": { "type": "string" }, "page_link": { "type": "string" } } }, "releases": { "type": "array", "items": { "type": "object", "required": [ "version", "release_title", "release_date", "pre_release", "release_notes", "download_files", "release_page_link" ], "properties": { "version": { "type": [ "string", "null" ] }, "pre_release": { "enum": [ "yes", "no" ], "type": "string" }, "release_date": { "type": [ "string", "null" ], "description": "Publication date in YYYY-MM-DD format." }, "release_notes": { "type": [ "string", "null" ], "description": "Plain text, truncated to 2,000 characters." }, "release_title": { "type": [ "string", "null" ] }, "download_files": { "type": "array", "items": { "type": "object", "required": [ "file_name", "download_count" ], "properties": { "file_name": { "type": "string" }, "download_count": { "type": "integer" } } } }, "release_page_link": { "type": "string" } } } } } } ``` ## See more - [GitHub API: List issues or pull requests](https://fous.com/methods/github.com/list-issues.md): Lists public issues or pull requests for a GitHub project, with state, label and sort options. A bare project name matches the most-starred repository with that name. - [GitHub API: Get repository facts](https://fous.com/methods/github.com/get-repository.md): Looks up a public GitHub repository by name, owner/name, or link and returns its stars, forks, release, commit and contributor facts. - [GitHub API: Search repositories](https://fous.com/methods/github.com/search-repositories.md): Finds public GitHub repositories by keywords, with an optional language filter and sort order. Returns up to 100 matches. - [GitHub API: List trending repositories](https://fous.com/methods/github.com/list-trending-repositories.md): Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period. - [NuGet API: Get package](https://fous.com/methods/nuget.org/get-package.md): Looks up a NuGet package by name or nuget.org link. Inexact names match the top search result. Returns the latest stable release's details and the 10 most recent versions, including prereleases. - [G2 API: Get product reviews](https://fous.com/methods/g2.com/get-product-reviews.md): Gets the newest public G2 reviews for a software product, with reviewer details and review text, plus the product's overall rating and review count when G2's profile shows them. The public feed exposes up to 25 recent reviews. - [PR Newswire API: Search press releases](https://fous.com/methods/prnewswire.com/search-press-releases.md): Finds PR Newswire press releases by company name or keywords, newest first, with optional publication date filters. - [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null. - [All GitHub methods](https://fous.com/methods/github.com.md)