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

# /2026-01/retail-media/auction-line-items/{lineItemId}

`GET /2026-01/retail-media/auction-line-items/{lineItemId}`

Gets a sponsored product line item by its id.

## Path parameters

- `lineItemId` string, required

## Response `200`

Success

- EntityResourceOutcomeOfSponsoredProductsLineItem — A top-level object that encapsulates a Criteo API response for a single entity.
  - `data` EntityResourceOfSponsoredProductsLineItem, nullable — A domain entity exposed by the API, identified by a unique id.
    - `attributes` SponsoredProductsLineItem, nullable — Model of a retail media auction line item.
      - `bidStrategy` 'manual' | 'automated' | 'unknown', nullable — Bid strategy for the line item.
      - `budget` number, double, nullable — The total budget allocated for this line item.
      - `budgetRemaining` number, double, nullable, required — The amount of the budget that remains available.
      - `budgetSpent` number, double, nullable — The amount of the budget that has been spent so far.
      - `campaignId` string, long-id, required — The ID of the campaign this line item belongs to.
      - `createdAt` string, date-time, required — The date and time when the line item was created.
      - `dailyPacing` number, double, nullable — The daily pacing limit for budget spending.
      - `endDate` string, date-time, nullable — The date and time when the line item stops running.
      - `flightSchedule` FlightSchedule, nullable — A flight schedule for a line item.
        - `legs` FlightLeg[], nullable — A list of flight legs on which the line item will run.
          - `dayOfWeek` 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'everyday' | 'weekdays' | 'weekends', required — Enum for the days of the week.
          - `endTime` string, required — Wall-clock time of day in HH:mm, 24-hour. No timezone.
          - `startTime` string, required — Wall-clock time of day in HH:mm, 24-hour. No timezone.
      - `isAutoDailyPacing` boolean, nullable — Indicates whether automatic daily pacing is enabled.
      - `keywordStrategy` 'unknown' | 'conquesting' | 'genericAndBranded' | 'genericBrandedAndConquesting', nullable — The keyword targeting strategy for this line item.
      - `maxBid` number, double, nullable — The maximum bid amount allowed for this line item.
      - `monthlyPacing` number, double, nullable — The monthly pacing limit for budget spending.
      - `name` string, required — The name of the line item.
      - `optimizationStrategy` 'conversion' | 'clicks' | 'revenue' | 'unknown', nullable — The optimization strategy for this line item.
      - `startDate` string, date-time, required — The date and time when the line item starts running.
      - `status` 'unknown' | 'active' | 'scheduled' | 'draft' | 'paused' | 'budgetHit' | 'ended' | 'archived' | 'noFunds', nullable — The current status of the line item.
      - `targetBid` number, double, nullable — The target bid amount for the line item.
      - `targetRetailerId` string, long-id, required — The ID of the retailer targeted by this line item.
      - `updatedAt` string, date-time, required — The date and time when the line item was last updated.
    - `id` string, nullable — Unique id of the entity.
    - `type` string, nullable — Type of the resource.
  - `errors` SdkApiRestCommonProblem[], nullable — Errors that occured during this call.
    - `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.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `warnings` SdkApiRestCommonProblem[], nullable — Warnings that occured during this call.
    - `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.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.

---

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