---
title: "POST /listRobotApplications"
method: POST
path: "/listRobotApplications"
---

# POST /listRobotApplications

`POST /listRobotApplications`

Returns a list of robot application. You can optionally provide filters to retrieve specific robot applications.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `versionQualifier` string — The version qualifier of the robot application.
  - `nextToken` string — If the previous paginated request did not return all of the remaining results, the response object's <code>nextToken</code> parameter value is set to a token. To retrieve the next set of results, call <code>ListRobotApplications</code> again and assign that token to the request object's <code>nextToken</code> parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.
  - `maxResults` integer — When this parameter is used, <code>ListRobotApplications</code> only returns <code>maxResults</code> results in a single page along with a <code>nextToken</code> response element. The remaining results of the initial request can be seen by sending another <code>ListRobotApplications</code> request with the returned <code>nextToken</code> value. This value can be between 1 and 100. If this parameter is not used, then <code>ListRobotApplications</code> returns up to 100 results and a <code>nextToken</code> value if applicable.
  - `filters` Filter[] — <p>Optional filters to limit results.</p> <p>The filter name <code>name</code> is supported. When filtering, you must use the complete value of the filtered item. You can use up to three filters.</p>
    - `name` string — The name of the filter.
    - `values` Name[] — A list of values.

## Response `200`

Success

- ListRobotApplicationsResponse
  - `robotApplicationSummaries` RobotApplicationSummary[] — A list of robot application summaries that meet the criteria of the request.
    - `name` string — The name of the robot application.
    - `arn` string — The Amazon Resource Name (ARN) of the robot.
    - `version` string — The version of the robot application.
    - `lastUpdatedAt` string, date-time — The time, in milliseconds since the epoch, when the robot application was last updated.
    - `robotSoftwareSuite` object — Information about a robot software suite (ROS distribution).
      - `name` 'ROS' | 'ROS2' | 'General' — The name of the robot software suite (ROS distribution).
      - `version` 'Kinetic' | 'Melodic' | 'Dashing' | 'Foxy' — The version of the robot software suite (ROS distribution).
  - `nextToken` string — If the previous paginated request did not return all of the remaining results, the response object's <code>nextToken</code> parameter value is set to a token. To retrieve the next set of results, call <code>ListRobotApplications</code> again and assign that token to the request object's <code>nextToken</code> parameter. If there are no remaining results, the previous response object's NextToken parameter is set to null.

## Other responses

- `480` — InvalidParameterException
- `481` — ThrottlingException
- `482` — InternalServerException

---

[API](https://skmtc.net/aws/apis/robomaker.md) · [All operations](https://skmtc.net/aws/apis/robomaker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/robomaker/versions/a6f68d7d4866/schema)