Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Applications applicationId Versions

Focus mode
Applications applicationId Versions - AWS Serverless Application Repository

URI

/applications/applicationId/versions

HTTP methods

GET

Operation ID: ListApplicationVersions

Lists versions for the specified application.

Path parameters
NameTypeRequiredDescription
applicationIdStringTrue

The Amazon Resource Name (ARN) of the application.

Query parameters
NameTypeRequiredDescription
maxItemsStringFalse

The total number of items to return.

nextTokenStringFalse

A token to specify where to start paginating.

Responses
Status codeResponse modelDescription
200ApplicationVersionPage

Success

400BadRequestException

One of the parameters in the request is invalid.

403ForbiddenException

The client is not authenticated.

404NotFoundException

The resource (for example, an access policy statement) specified in the request doesn't exist.

429TooManyRequestsException

The client is sending more than the allowed number of requests per unit of time.

500InternalServerErrorException

The AWS Serverless Application Repository service encountered an internal error.

OPTIONS

Path parameters
NameTypeRequiredDescription
applicationIdStringTrue

The Amazon Resource Name (ARN) of the application.

Responses
Status codeResponse modelDescription
200None

200 response

Schemas

Response bodies

{ "versions": [ { "applicationId": "string", "semanticVersion": "string", "sourceCodeUrl": "string", "creationTime": "string" } ], "nextToken": "string" }

ApplicationVersionPage schema

{ "versions": [ { "applicationId": "string", "semanticVersion": "string", "sourceCodeUrl": "string", "creationTime": "string" } ], "nextToken": "string" }
{ "message": "string", "errorCode": "string" }

BadRequestException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

ForbiddenException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

NotFoundException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

TooManyRequestsException schema

{ "message": "string", "errorCode": "string" }
{ "message": "string", "errorCode": "string" }

InternalServerErrorException schema

{ "message": "string", "errorCode": "string" }

Properties

ApplicationVersionPage

A list of version summaries for the application.

PropertyTypeRequiredDescription
nextToken

string

False

The token to request the next page of results.

versions

Array of type VersionSummary

True

An array of version summaries for the application.

BadRequestException

One of the parameters in the request is invalid.

PropertyTypeRequiredDescription
errorCode

string

False

400

message

string

False

One of the parameters in the request is invalid.

ForbiddenException

The client is not authenticated.

PropertyTypeRequiredDescription
errorCode

string

False

403

message

string

False

The client is not authenticated.

InternalServerErrorException

The AWS Serverless Application Repository service encountered an internal error.

PropertyTypeRequiredDescription
errorCode

string

False

500

message

string

False

The AWS Serverless Application Repository service encountered an internal error.

NotFoundException

The resource (for example, an access policy statement) specified in the request doesn't exist.

PropertyTypeRequiredDescription
errorCode

string

False

404

message

string

False

The resource (for example, an access policy statement) specified in the request doesn't exist.

TooManyRequestsException

The client is sending more than the allowed number of requests per unit of time.

PropertyTypeRequiredDescription
errorCode

string

False

429

message

string

False

The client is sending more than the allowed number of requests per unit of time.

VersionSummary

An application version summary.

PropertyTypeRequiredDescription
applicationId

string

True

The application Amazon Resource Name (ARN).

creationTime

string

True

The date and time this resource was created.

semanticVersion

string

True

The semantic version of the application:

https://semver.org/

sourceCodeUrl

string

False

A link to a public repository for the source code of your application, for example the URL of a specific GitHub commit.

See also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

ListApplicationVersions

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.