ListApplications - AWS Mainframe Modernization


Lists the applications associated with a specific AWS account. You can provide the unique identifier of a specific runtime environment in a query parameter to see all applications associated with that environment.

Request Syntax

GET /applications?environmentId=environmentId&maxResults=maxResults&names=names&nextToken=nextToken HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The unique identifier of the runtime environment where the applications are deployed.

Pattern: ^\S{1,80}$


The maximum number of applications to return.

Valid Range: Minimum value of 1. Maximum value of 2000.


The names of the applications.

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_\-]{1,59}$


A pagination token to control the number of applications displayed in the list.

Pattern: ^\S{1,2000}$

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "applications": [ { "applicationArn": "string", "applicationId": "string", "applicationVersion": number, "creationTime": number, "deploymentStatus": "string", "description": "string", "engineType": "string", "environmentId": "string", "lastStartTime": number, "name": "string", "roleArn": "string", "status": "string", "versionStatus": "string" } ], "nextToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


Returns a list of summary details for all the applications in a runtime environment.

Type: Array of ApplicationSummary objects


A pagination token that's returned when the response doesn't contain all applications.

Type: String

Pattern: ^\S{1,2000}$


For information about the errors that are common to all actions, see Common Errors.


The account or role doesn't have the right permissions to make the request.

HTTP Status Code: 403


An unexpected error occurred during the processing of the request.

HTTP Status Code: 500


The number of requests made exceeds the limit.

HTTP Status Code: 429


One or more parameters provided in the request is not valid.

HTTP Status Code: 400

See Also

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