---
title: "List a repo's releases"
method: GET
path: "/repos/{owner}/{repo}/releases"
tags: ["repository"]
---

# List a repo's releases

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

## Path parameters

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

## Query parameters

- `draft` boolean
- `pre-release` boolean
- `tag_filter` string
- `page` integer
- `limit` integer

## Response `200`

ReleaseList

- Release[]
  - `assets` Attachment[] — The files attached to the release
    - `browser_download_url` string — DownloadURL is the URL to download the attachment
    - `created_at` string, date-time — Created is the time when the attachment was uploaded
    - `download_count` integer — DownloadCount is the number of times the attachment has been downloaded
    - `id` integer — ID is the unique identifier for the attachment
    - `name` string — Name is the filename of the attachment
    - `size` integer — Size is the file size in bytes
    - `uuid` string — UUID is the unique identifier for the attachment file
  - `author` User — User represents a user
    - `active` boolean — Is user active
    - `avatar_url` string — URL to the user's avatar
    - `created` string, date-time
    - `description` string — the user's description
    - `email` string, email
    - `followers_count` integer — user counts
    - `following_count` integer
    - `full_name` string — the user's full name
    - `html_url` string — URL to the user's gitea page
    - `id` integer — the user's id
    - `is_admin` boolean — Is the user an administrator
    - `language` string — User locale
    - `last_login` string, date-time
    - `location` string — the user's location
    - `login` string — login of the user, same as `username`
    - `login_name` string — identifier of the user, provided by the external authenticator (if configured)
    - `prohibit_login` boolean — Is user login prohibited
    - `restricted` boolean — Is user restricted
    - `source_id` integer — The ID of the user's Authentication Source
    - `starred_repos_count` integer
    - `visibility` 'public' | 'limited' | 'private' — User visibility level option: public, limited, private
    - `website` string — the user's website
  - `body` string — The release notes or description
  - `created_at` string, date-time
  - `draft` boolean — Whether the release is a draft
  - `html_url` string — The HTML URL to view the release
  - `id` integer — The unique identifier of the release
  - `name` string — The display title of the release
  - `prerelease` boolean — Whether the release is a prerelease
  - `published_at` string, date-time
  - `tag_name` string — The name of the git tag associated with the release
  - `tarball_url` string — The URL to download the tarball archive
  - `target_commitish` string — The target commitish for the release
  - `upload_url` string — The URL template for uploading release assets
  - `url` string — The API URL of the release
  - `zipball_url` string — The URL to download the zip archive

## Other responses

- `404` — APINotFound is a not found empty response

---

[API](https://skmtc.net/gitea/apis/gitea-api.md) · [All operations](https://skmtc.net/gitea/apis/gitea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitea/gitea-api/versions/350de506cefa/schema)