---
title: "List releases"
method: GET
path: "/repos/{owner}/{repo}/releases"
tags: ["Releases"]
---

# List releases

`GET /repos/{owner}/{repo}/releases`

## Request

- Base URL: `https://gogs.example.com/api/v1`
- URL: `https://gogs.example.com/api/v1/repos/{owner}/{repo}/releases`
- Auth: API key in header `Authorization`

## Path parameters

- `owner` string, required
- `repo` string, required

## Response `200`

Success

- Release[]
  - `id` integer
  - `tag_name` string
  - `target_commitish` string
  - `name` string
  - `body` string
  - `draft` boolean
  - `prerelease` boolean
  - `author` User
    - `id` integer
    - `username` string
    - `login` string: Alias of username for GitHub API compatibility
    - `full_name` string
    - `email` string, email
    - `avatar_url` string
  - `created_at` string, date-time

## Other responses

- `404`: Resource not found.

---

[API](https://skmtc.dev/gogs/apis/gogs-api.md) - [All operations](https://skmtc.dev/gogs/apis/gogs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gogs/apis/gogs-api/revisions/9cfa27470692?raw)