v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1438166195.6 KB

Gets the readme file or descriptive text for a package version.

The returned text might contain formatting. For example, it might contain formatting for Markdown or reStructuredText.

get/v1/package/version/readme#domain&repository&format&package&version

Query parameters

domainstring required

The name of the domain that contains the repository that contains the package version with the requested readme file.

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 repository that contains the package with the requested readme file.

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

A format that specifies the type of the package version with the requested readme file.

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

The name of the package version that contains the requested readme file.

versionstring required

A string that contains the package version (for example, <code>3.5.2</code>).

Response

Success

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

The format of the package with the requested readme file.

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

The name of the package that contains the returned readme file.

versionstring

The version of the package with the requested readme file.

versionRevisionstring

The current revision associated with the package version.

readmestring

The text of the returned readme file.