---
title: "/2026-01/retail-media/reports/line-items"
method: POST
path: "/2026-01/retail-media/reports/line-items"
tags: ["Analytics"]
---

# /2026-01/retail-media/reports/line-items

`POST /2026-01/retail-media/reports/line-items`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/reports/line-items`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Analytics_Read`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/retail-media/reports/line-items/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns an asynchronous Line Items Report
<br />
This endpoint is subject to specific rate limits.

## Request body

- AsyncLineItemsReportRequest: A top-level object that encapsulates a Criteo API request for a single value
  - `data` AsyncLineItemsReportResource: A top-level object that encapsulates a Criteo API response for a single value
    - `attributes` AsyncLineItemsReport: Async Line Items report body request
      - `activationPlatforms` string[]: Filter on the activation platform: CommerceMax, PrivateMarket
      - `budgetModels` string[]: Filter on the budget model: CriteoBudget, RetailerBudget
      - `buyTypes` string[]: Filter on the buy type: auction, preferredDeals, sponsorship
      - `campaignType` 'all' | 'sponsoredProducts' | 'onSiteDisplays': Filter the type of campaigns to report on: sponsoredProducts or onSiteDisplays
      - `clickAttributionWindow` 'none' | '7D' | '14D' | '30D': Click attribution window
      - `dimensions` string[]: List of dimensions to report on
      - `endDate` string, date-time, required: End date
      - `format` 'json' | 'json-compact' | 'json-newline' | 'csv': Format of the output
      - `id` string: Line Item id to report on
      - `ids` string[]: Line Item ids to report on
      - `mediaType` 'unknown' | 'video' | 'display' | 'all': Filter on the type of media: unknown, display, video
      - `metrics` string[]: List of metrics to report on
      - `reportType` 'summary' | 'pageType' | 'keyword' | 'productCategory' | 'product' | 'attributedTransactions' | 'environment' | 'servedCategory' | 'capout': Type of report, if no dimensions and metrics are provided, falls back to summary reportType
      - `salesChannel` 'online' | 'offline' | 'all': Filter on specific sales channel: offline or online
      - `searchTermTargetings` string[]: Filter on the type of search term targeting: unknown, automatic, manual
      - `searchTermTypes` string[]: Filter on the type of search term type: unknown, searched, entered
      - `startDate` string, date-time, required: Start date
      - `targetedKeywordTypes` string[]: Filter on targeted keyword type: unknown, generic, branded, conquesting
      - `timezone` string: Time zone : see criteo developer portal for supported time zones
      - `viewAttributionWindow` 'none' | '1D' | '7D' | '14D' | '30D': View attribution window
    - `type` string

## Response `200`

Success

- AsyncReportResponse: Async Report response format
  - `data` StatusResponseResource, nullable: A class that represents a domain entity exposed by an API
    - `attributes` StatusResponse, nullable: Status of an async report request
      - `createdAt` string, nullable
      - `expiresAt` string, nullable
      - `fileSizeBytes` integer, nullable
      - `id` string, nullable
      - `md5CheckSum` string, nullable
      - `message` string, nullable
      - `rowCount` integer, nullable
      - `status` 'pending' | 'success' | 'failure' | 'expired', nullable
    - `id` string, nullable
    - `type` string, nullable
  - `errors` CommonProblem[], 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
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `warnings` CommonProblem[], 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
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `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)