---
title: "List of Recommendations"
method: POST
path: "/v1/recommendations/list"
tags: ["Recommendation"]
---

# List of Recommendations

`POST /v1/recommendations/list`

Fetch a List of Recommendation

## Request body

- ListRecommendationRequest
  - `list_context` ListContext
    - `batch_size` integer — Max number of ids in the response
    - `batch_offset` integer — Offset of batches into the results. First batch is 0
    - `total` integer — Total number of results
  - `filters` ListRecommendationFilters
    - `tenant_ids` string[], required — List of Tenant Ids to get the recommendation rules.
    - `service_account_ids` string[] — List of service account IDs to get the recommendation details. If empty, all accounts will be selected by default.
    - `policy_classifications` PolicyClassificationWithSubClassifications
      - `access` string[] — List of Access sub-classifications
      - `cost` string[] — List of Cost sub-classifications
      - `data` string[] — List of Data sub-classifications
      - `network` string[] — List of Network sub-classifications
      - `operation` string[] — List of Operation sub-classifications
      - `performance` string[] — List of performance sub-classifications
      - `resource` string[] — List of Resource sub-classifications
      - `security` string[] — List of security sub classifications
    - `policy_ids` string[] — List of policy ids to get the recommendations.
    - `resource_ids` string[] — List of resource ids to get the recommendations.
    - `resource_types` string[] — List of resource types to get the recommendations.
    - `resources` string[] — List of resources to get the recommendations.
    - `service_names` string[] — List of cloud service name
    - `sources` string[] — List of recommendation source to filter the recommendations.
    - `statuses` string[] — List of recommendation status to filter the recommendations.

## Response `200`

Success

- ListResponse
  - `results` string[] — List of result identifiers
  - `next_list_context` ListContext
    - `batch_size` integer — Max number of ids in the response
    - `batch_offset` integer — Offset of batches into the results. First batch is 0
    - `total` integer — Total number of results

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)