> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bid Strategy Settings

> Retrieve bidding settings for an Onsite Display auction line item.

export const EndpointBadge = ({method = "GET", children}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-[#2AB673]"
    },
    POST: {
      bg: "mint-bg-[#3064E3]"
    },
    PUT: {
      bg: "mint-bg-[#C28C30]"
    },
    PATCH: {
      bg: "mint-bg-[#DA622B]"
    },
    DELETE: {
      bg: "mint-bg-[#CB3A32]"
    },
    API: {
      bg: "mint-bg-black"
    }
  };
  const key = method.toUpperCase();
  const styles = METHOD_STYLES[key] ?? METHOD_STYLES.API;
  return <div className="relative mt-7">
      <span className={`absolute -top-2 -left-2 z-10 ${styles.bg} text-white px-2.5 py-0.5 rounded-full text-xs font-bold tracking-wide`}>
        {key}
      </span>
      {children}
    </div>;
};

## Overview

Use the bid strategy settings endpoint to retrieve the current CPM bidding configuration for an Onsite Display auction line item.

<Info>
  This endpoint currently supports Display auction line items only. Sponsored Products and other line item types are not supported.
</Info>

The response identifies the active strategy and includes preserved settings for the inactive strategy when available. This allows clients to inspect both Standard page-type bids and the Adaptive maximum bid without losing previously configured values.

## Retrieve bid strategy settings

<EndpointBadge method="get">
  ```http theme={null}
  https://api.criteo.com/experimental/retail-media/line-items/{line-item-id}/bidding-strategy
  ```
</EndpointBadge>

### Path parameter

| Parameter      | Type   | Required | Description                                  |
| -------------- | ------ | -------- | -------------------------------------------- |
| `line-item-id` | string | Yes      | Identifier of the Display auction line item. |

The authenticated user must have permission to view the requested line item.

### Sample request

```bash theme={null}
curl -X GET "https://api.criteo.com/experimental/retail-media/line-items/123456789012345678/bidding-strategy" \
  -H "Authorization: Bearer <MY_ACCESS_TOKEN>" \
  -H "Accept: application/json"
```

### Response attributes

All attributes below are nested under `data.attributes` in the response envelope.

| Attribute                                            | Type           | Description                                     |
| ---------------------------------------------------- | -------------- | ----------------------------------------------- |
| `cpm`                                                | object or null | CPM-specific bidding configuration.             |
| `cpm.bidStrategy`                                    | string         | Active strategy: `Standard` or `Adaptive`.      |
| `cpm.standardBiddingSettings`                        | object or null | Active or preserved Standard strategy settings. |
| `cpm.standardBiddingSettings.auctionBids`            | array          | Manual bid amounts configured by page type.     |
| `cpm.standardBiddingSettings.auctionBids[].pageType` | string         | Page type to which the bid applies.             |
| `cpm.standardBiddingSettings.auctionBids[].bid`      | number         | Bid amount in the line item's currency.         |
| `cpm.adaptiveBiddingSettings`                        | object or null | Active or preserved Adaptive strategy settings. |
| `cpm.adaptiveBiddingSettings.maxBid`                 | number or null | Maximum bid that the Adaptive strategy may use. |

Supported `pageType` contract values are `Unknown`, `Search`, `Home`, `Browse`, `Checkout`, `Category`, `ProductDetail`, `Confirmation`, `Merchandising`, `Deals`, `Favorites`, `SearchBar`, `CategoryMenu`, and `AiAssistant`. Availability depends on the retailer and line item configuration.

### Sample response

```json theme={null}
{
  "data": {
    "type": "BiddingSettings",
    "attributes": {
      "cpm": {
        "bidStrategy": "Adaptive",
        "standardBiddingSettings": {
          "auctionBids": [
            {
              "pageType": "Search",
              "bid": 1.25
            }
          ]
        },
        "adaptiveBiddingSettings": {
          "maxBid": 3.5
        }
      }
    }
  }
}
```

## Responses

| Status            | Description                                                                                                                                        |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200 OK`          | Returns the current bidding settings.                                                                                                              |
| `400 Bad Request` | The line item type is not supported. The error code is `unsupported-line-item-type`.                                                               |
| `403 Forbidden`   | The line item does not exist or is not accessible. For security, the response does not identify which condition occurred or include an error code. |