Skip to content
forgit api docs

List a repository's tags

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

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 ”

200

Section titled “ 200 ”

TagList

Media type application/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

Section titled “ Headers ”
X-Total-Count
integer format: int64

The total number of tags

404

Section titled “ 404 ”

APINotFound is a not found error response

Media type application/json
object
errors
Array<string>
message
string
url
string
Example generated 
{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}