List a repository's tags
GET
/repos/{owner}/{repo}/tags
const url = 'https://gitea.com/api/v1/repos/example/example/tags';const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://gitea.com/api/v1/repos/example/example/tags \ --header 'Authorization: Basic <credentials>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”owner
required
string
Owner of the repo
repo
required
string
Name of the repo
Query Parameters
Section titled “Query Parameters”page
integer
Page number of results to return (1-based)
limit
integer
Page size of results, default maximum page size is 50
Responses
Section titled “Responses”TagList
Media typeapplication/json
Array<object>
Tag represents a repository tag
object
commit
CommitMeta contains meta information of a commit in terms of API.
object
created
string format: date-time
sha
SHA is the commit SHA hash
string
url
URL is the API URL for the commit
string
id
The ID (SHA) of the tag
string
message
The message associated with the tag
string
name
The name of the tag
string
tarball_url
The URL to download the tarball archive
string
zipball_url
The URL to download the zipball archive
string
Examplegenerated
[ { "commit": { "created": "2026-04-15T12:00:00Z", "sha": "example", "url": "example" }, "id": "example", "message": "example", "name": "example", "tarball_url": "example", "zipball_url": "example" }]APINotFound is a not found empty response
Media typeapplication/json