List a repository's tags

GET

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

Authorizations

• BasicAuth
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

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

200

TagList

Media typeapplication/json

Array<object>

Tag represents a repository tag

object

archive_download_count

TagArchiveDownloadCount counts how many times a archive was downloaded

object

tar_gz

integer format: int64

zip

integer format: int64

commit

CommitMeta contains meta information of a commit in terms of API.

object

created

string format: date-time

sha

string

url

string

id

string

message

string

name

string

tarball_url

string

zipball_url

string

Example^generated

[
  {
    "archive_download_count": {
      "tar_gz": 1,
      "zip": 1
    },
    "commit": {
      "created": "2026-04-15T12:00:00Z",
      "sha": "example",
      "url": "example"
    },
    "id": "example",
    "message": "example",
    "name": "example",
    "tarball_url": "example",
    "zipball_url": "example"
  }
]

Headers

X-Total-Count

integer format: int64

The total number of tags

404

APINotFound is a not found error response

Media typeapplication/json

object

errors

Array<string>

message

string

url

string

Example^generated

{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}