---
title: "GET /recommendations"
method: GET
path: "/recommendations"
---

# GET /recommendations

`GET /recommendations`

Lists all recommendations in the account, with optional filtering by status.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'DELETING' — The lifecycle status of a recommendation.

## Response `200`

Success

- ListRecommendationsResponse
  - `recommendationSummaries` RecommendationSummary[], required — The list of recommendation summaries.
    - `recommendationId` string, required — The unique identifier of the recommendation.
    - `recommendationArn` string, required — The Amazon Resource Name (ARN) of the recommendation.
    - `name` string, required — The name of the recommendation.
    - `description` string — The description of the recommendation.
    - `type` 'SYSTEM_PROMPT_RECOMMENDATION' | 'TOOL_DESCRIPTION_RECOMMENDATION', required — The type of recommendation.
    - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'DELETING', required — The current status of the recommendation.
    - `createdAt` string, date-time, required — The timestamp when the recommendation was created.
    - `updatedAt` string, date-time, required — The timestamp when the recommendation was last updated.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — InternalServerException

---

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