---
title: "List all releases in a project"
method: GET
path: "/api/v4/projects/{id}/releases"
tags: ["releases"]
---

# List all releases in a project

`GET /api/v4/projects/{id}/releases`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/releases`
- Auth: none declared

Lists all releases for a specified project. Sorted by `released_at`.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `order_by` 'released_at' | 'created_at'
- `sort` 'asc' | 'desc'
- `include_html_description` boolean
- `updated_before` string, date-time
- `updated_after` string, date-time

## Response `200`

List all releases in a project

- APIEntitiesRelease[]
  - `name` string, required
  - `tag_name` string, required
  - `description` string, required
  - `created_at` string, date-time, required
  - `released_at` string, date-time, required
  - `upcoming_release` boolean, required
  - `description_html` string
  - `author` APIEntitiesUserBasic: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `commit` APIEntitiesCommit: API_Entities_Commit model
    - `id` string, required
    - `short_id` string, required
    - `created_at` string, date-time, required
    - `parent_ids` string[], required
    - `title` string, required
    - `message` string, required
    - `author_name` string, required
    - `author_email` string, required
    - `authored_date` string, date-time, required
    - `committer_name` string, required
    - `committer_email` string, required
    - `committed_date` string, date-time, required
    - `trailers` object, required
    - `extended_trailers` object, required
    - `web_url` string, required
  - `milestones` APIEntitiesMilestoneWithStats
    - `id` integer, required
    - `iid` integer, required
    - `project_id` integer
    - `group_id` string
    - `title` string, required
    - `description` string, required
    - `state` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `due_date` string, required
    - `start_date` string, required
    - `expired` boolean, required
    - `web_url` string, required
    - `issue_stats` object, required
      - `total` integer, required
      - `closed` integer, required
  - `commit_path` string
  - `tag_path` string
  - `assets` object, required
    - `count` integer, required
    - `sources` APIEntitiesReleasesSource
      - `format` string, required
      - `url` string, required
    - `links` APIEntitiesReleasesLink, required: API_Entities_Releases_Link model
      - `id` integer, required
      - `name` string, required
      - `url` string, required
      - `direct_asset_url` string, required
      - `link_type` string, required
  - `evidences` APIEntitiesReleasesEvidence
    - `sha` string, required
    - `filepath` string, required
    - `collected_at` string, date-time, required
  - `_links` object, required
    - `closed_issues_url` string
    - `closed_merge_requests_url` string
    - `edit_url` string
    - `merged_merge_requests_url` string
    - `opened_issues_url` string
    - `opened_merge_requests_url` string
    - `self` string

---

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