---
title: "Search cost recommendations"
method: POST
path: "/api/v2/cost/recommendations"
tags: ["Cloud Cost Management"]
---

# Search cost recommendations

`POST /api/v2/cost/recommendations`

List cost recommendations matching a filter, with pagination and sorting.

## Query parameters

- `page[size]` string
- `page[token]` string

## Request body

- RecommendationsFilterRequest — Request body for filtering cost recommendations.
  - `filter` string — Filter expression applied to the recommendations.
  - `sort` RecommendationsFilterRequestSortItems[] — Ordered list of sort clauses applied to the result set.
    - `expression` string — Field to sort by (for example, `potential_daily_savings.amount`).
    - `order` string — Sort direction, either `ASC` or `DESC`.
  - `view` string — Active view name (for example, `active`, `dismissed`, `open`, `in-progress`, or `completed`).

## Response `200`

OK

- CostRecommendationArray — A page of cost recommendations with pagination metadata.
  - `data` CostRecommendationData[], required — The list of cost recommendations on this page.
    - `attributes` CostRecommendationDataAttributes — Attributes describing a single cost recommendation.
      - `dd_resource_key` string — Datadog resource key identifying the recommended resource.
      - `potential_daily_savings` CostRecommendationDataAttributesPotentialDailySavings — Estimated daily savings if the recommendation is applied.
        - `amount` number, double — Numeric amount of the potential daily savings.
        - `currency` string — ISO 4217 currency code for the savings amount.
      - `recommendation_type` string — The kind of recommendation (for example, `terminate` or `rightsize`).
      - `resource_id` string — Cloud provider identifier of the resource.
      - `resource_type` string — Resource type (for example, `aws_ec2_instance`).
      - `tags` string[] — Tags attached to the recommended resource.
    - `id` string — Unique identifier for the recommendation.
    - `type` 'recommendation', required — Recommendation resource type.
  - `meta` RecommendationsPageMeta — Top-level JSON:API meta object for paginated cost recommendation responses.
    - `page` RecommendationsPageMetaPage — Pagination metadata for a page of cost recommendations.
      - `filter` string — The filter expression that was applied to produce this page.
      - `next_page_token` string — Opaque token used to fetch the next page; absent on the last page.
      - `page_size` integer — Number of items returned in this page (1–10000).
      - `page_token` string — Pagination token echoed back from the request.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)