Sample - GitHub REST API
GET/orgs/{org}/packages/{package_type}/{package_name}/versions

List package versions for a package owned by an organization

Lists package versions for a package owned by an organization.

OAuth app tokens and personal access tokens (classic) need the read:packages scope to use this endpoint. For more information, see "About permissions for GitHub Packages."

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

6 parameters
package_typestringrequired
The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry (`ghcr.io`) have the type `container`. You can use the type `docker` to find images that were pushed to GitHub's Docker registry (`docker.pkg.github.com`), even if these have now been migrated to the Container registry.
Allowed:npmmavenrubygemsdockernugetcontainer
package_namestringrequired
The name of the package.
orgstringrequired
The organization name. The name is not case sensitive.
pageintegeroptional
The page number of the results to fetch. For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Default:1
per_pageintegeroptional
The number of results per page (max 100). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)."
Default:30
statestringoptional
The state of the package, either active or deleted.
Allowed:activedeletedDefault:active

4 status codes
200Response
idintegerrequired
Unique identifier of the package version.
namestringrequired
The name of the package version.
urlstringrequired
package_html_urlstringrequired
html_urlstringoptional
licensestringoptional
descriptionstringoptional
created_atstringrequired
updated_atstringrequired
deleted_atstringoptional
metadataobjectoptional
401Requires authentication
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
403Forbidden
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
404Resource not found
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 404 is returned: Resource not found.