Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1438166195.6 KB

Returns a list of <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageVersionSummary.html">PackageVersionSummary</a> objects for package versions in a repository that match the request parameters. Package versions of all statuses will be returned by default when calling <code>list-package-versions</code> with no <code>--status</code> parameter.

post/v1/package/versions#domain&repository&format&package

Query parameters

domainstring required

The name of the domain that contains the repository that contains the requested package versions.

domain-ownerstring

The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.

repositorystring required

The name of the repository that contains the requested package versions.

format'npm' | 'pypi' | 'maven' | 'nuget' | 'generic' required

The format of the package versions you want to list.

namespacestring
<p>The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:</p> <ul> <li> <p> The namespace of a Maven package is its <code>groupId</code>. </p> </li> <li> <p> The namespace of an npm package is its <code>scope</code>. </p> </li> <li> <p> Python and NuGet packages do not contain a corresponding component, packages of those formats do not have a namespace. </p> </li> <li> <p> The namespace of a generic package is its <code>namespace</code>. </p> </li> </ul>
packagestring required

The name of the package for which you want to request package versions.

status'Published' | 'Unfinished' | 'Unlisted' | 'Archived' | 'Disposed' | 'Deleted'

A string that filters the requested package versions by status.

sortBy'PUBLISHED_TIME'

How to sort the requested list of package versions.

max-resultsinteger

The maximum number of results to return per page.

next-tokenstring

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

originType'INTERNAL' | 'EXTERNAL' | 'UNKNOWN'

The <code>originType</code> used to filter package versions. Only package versions with the provided <code>originType</code> will be returned.

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Response

Success

defaultDisplayVersionstring
<p> The default package version to display. This depends on the package format: </p> <ul> <li> <p> For Maven and PyPI packages, it's the most recently published package version. </p> </li> <li> <p> For npm packages, it's the version referenced by the <code>latest</code> tag. If the <code>latest</code> tag is not set, it's the most recently published package version. </p> </li> </ul>
format'npm' | 'pypi' | 'maven' | 'nuget' | 'generic'

A format of the package.

namespacestring
<p>The namespace of the package that contains the requested package versions. The package component that specifies its namespace depends on its type. For example:</p> <ul> <li> <p> The namespace of a Maven package is its <code>groupId</code>. </p> </li> <li> <p> The namespace of an npm package is its <code>scope</code>. </p> </li> <li> <p> Python and NuGet packages do not contain a corresponding component, packages of those formats do not have a namespace. </p> </li> </ul>
packagestring

The name of the package.

nextTokenstring

If there are additional results, this is the token for the next set of results.