Get the tag of a repository by tag name

GET

/repos/{owner}/{repo}/tags/{tag}

curl --request GET \
  --url https://gitea.com/api/v1/repos/example/example/tags/example \
  --header 'Authorization: Basic <credentials>'

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

tag

required

string

Name of tag

Responses

200

Tag

Media typeapplication/json

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 format: uri

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 format: uri

zipball_url

The URL to download the zipball archive

string format: uri

Example^generated

{
  "commit": {
    "created": "2026-04-15T12:00:00Z",
    "sha": "example",
    "url": "https://example.com"
  },
  "id": "example",
  "message": "example",
  "name": "example",
  "tarball_url": "https://example.com",
  "zipball_url": "https://example.com"
}

404

APINotFound is a not found empty response