---
title: "get a list of releases for a repository"
method: GET
path: "/hosts/{hostName}/repositories/{repositoryName}/releases"
---

# get a list of releases for a repository

`GET /hosts/{hostName}/repositories/{repositoryName}/releases`

## Request

- Base URL: `https://repos.ecosyste.ms/api/v1`
- URL: `https://repos.ecosyste.ms/api/v1/hosts/{hostName}/repositories/{repositoryName}/releases`
- Auth: none declared

## Path parameters

- `hostName` string, required
- `repositoryName` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string
- `order` string

## Response `200`

OK

- Tag[]
  - `name` string
  - `sha` string
  - `kind` string
  - `published_at` string, date-time
  - `download_url` string
  - `html_url` string
  - `dependencies_parsed_at` string, date-time
  - `dependency_job_id` string
  - `purl` string
  - `tag_url` string
  - `manifests_url` string
  - `release_url` string, nullable: API URL of the release attached to this tag (null if the tag has no release)

## Changes

- **2026-09-29** (v1) `dae497f2cdf7`: 1 info
  - added the optional property `items/release_url` to the response with the `200` status
- **2025-06-11** (v1) `1f66d413eaa1`: 1 info
  - added the optional property `items/purl` to the response with the `200` status
- **2024-01-17** (v1) `c65e509b79d0`: 1 info
  - api operation id `getHostRepositoryTags` removed and replaced with `getHostRepositoryReleases`
- **2023-10-12** (v1) `27a6d4e88066`: 2 info
  - added the new optional `query` request parameter `order`
  - added the new optional `query` request parameter `sort`
- **2023-07-18** (v1) `ff3bd38ae9a3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/changes/hosts/:hostName/repositories/:repositoryName/releases/get.md)

---

[API](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos.md) - [All operations](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/llms.txt) - [OpenAPI document](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/revisions/dae497f2cdf7?raw)