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

# get a release for a repository

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

## Request

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

## Path parameters

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

## Response `200`

OK

- Release
  - `name` string
  - `uuid` string
  - `tag_name` string
  - `target_commitish` string
  - `body` string
  - `draft` boolean
  - `prerelease` boolean
  - `published_at` string, date-time
  - `created_at` string, date-time
  - `author` string
  - `assets` object[]
  - `last_synced_at` string, date-time
  - `tag_url` string
  - `html_url` string
  - `tag` object, nullable: The tag this release is attached to (null if the tag has not been synced)
    - `name` string
    - `sha` string
    - `kind` string
    - `published_at` string, date-time

## Changes

- **2026-09-29** (v1) `dae497f2cdf7`: 1 info
  - added the optional property `tag` to the response with the `200` status
- **2024-01-17** (v1) `c65e509b79d0`: 1 info
  - api operation id `getHostRepositoryTag` removed and replaced with `getHostRepositoryRelease`
- **2023-12-06** (v1) `3dec3c31620b`: 1 info
  - added the optional property `html_url` to the response with the `200` status
- **2023-07-18** (v1) `537cd24a51f6`: 1 info
  - added the optional property `tag_url` to the response with the `200` status
- **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/:release/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)