---
title: "/2026-01/retail-media/line-items/{line-item-id}/products"
method: GET
path: "/2026-01/retail-media/line-items/{line-item-id}/products"
tags: ["Campaign"]
---

# /2026-01/retail-media/line-items/{line-item-id}/products

`GET /2026-01/retail-media/line-items/{line-item-id}/products`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/line-items/{line-item-id}/products`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Campaign_Read`

Retrieve a page of promoted products for a line item

## Path parameters

- `line-item-id` string, required

## Query parameters

- `fields` string
- `limit` integer
- `offset` integer

## Response `200`

Promoted products associated with the line item

- PromotedProductResourceCollectionOutcome: Outcome object containing promoted products.
  - `data` PromotedProductResource[], nullable
    - `attributes` PromotedProduct, nullable: A promoted product.
      - `bidOverride` number, nullable: The bid override for the promoted product for this line item. Ignored unless adding a product.
      - `id` string, nullable: A retailer defined SKU ID for the promoted product.
      - `status` 'unknown' | 'active' | 'paused', nullable: The status of a promoted product in the context of the line item.
    - `id` string, nullable
    - `type` string, nullable
  - `errors` RmcaCommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `status` integer, nullable: The problem's HTTP Status code.
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `meta` ProductMetadata, nullable: Metadata about the response. Used for pagination.
    - `count` integer, nullable: Total number of items available.
    - `limit` integer, nullable: Maximum number of items in the response.
    - `offset` integer, nullable: Zero based offset of the first item in the response.
    - `responseCount` integer, nullable: Number of items in the response.
  - `warnings` RmcaCommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `status` integer, nullable: The problem's HTTP Status code.
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)