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

# Search cost recommendations

`POST /api/v2/cost/recommendations`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/cost/recommendations`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `cloud_cost_management_read`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)