> ## 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.

# /experimental/retail-media/line-items/{line-item-id}

> Retrieves a consolidated line item view from the line item domain services.



## OpenAPI

````yaml https://api.criteo.com/experimental/retailmedia/open-api-specifications.json get /experimental/retail-media/line-items/{line-item-id}
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - RetailMedia
  version: Experimental
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Accounts
  - name: Analytics
  - name: Audience
  - name: Balance
  - name: Campaign
  - name: Catalog
  - name: Gateway
  - name: OnSiteRecommendation
  - name: ThirdPartyAccounts
paths:
  /experimental/retail-media/line-items/{line-item-id}:
    get:
      tags:
        - Campaign
      summary: /experimental/retail-media/line-items/{line-item-id}
      description: >-
        Retrieves a consolidated line item view from the line item domain
        services.
      operationId: GetLineItem
      parameters:
        - name: line-item-id
          in: path
          description: The line item identifier.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LineItemDetailsResponse'
      security:
        - oauth:
            - RetailMedia_Campaign_Read
components:
  schemas:
    LineItemDetailsResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/LineItemDetailsResource'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/CommonProblem'
          description: Errors that occured during this call.
          nullable: true
          readOnly: true
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/CommonProblem'
          description: Warnings that occured during this call.
          nullable: true
          readOnly: true
      additionalProperties: false
      description: >-
        A top-level object that encapsulates a Criteo API response for a single
        entity.
    LineItemDetailsResource:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/LineItemDetails'
        id:
          type: string
          description: Unique id of the entity.
          nullable: true
        type:
          type: string
          description: Type of the resource.
          nullable: true
      additionalProperties: false
      description: A domain entity exposed by the API, identified by a unique id.
      nullable: true
    CommonProblem:
      type: object
      properties:
        code:
          type: string
          description: A machine-readable error code, expressed as a string value.
          nullable: true
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem
          nullable: true
        instance:
          type: string
          description: A URI that identifies the specific occurrence of the problem.
          nullable: true
        source:
          type: object
          additionalProperties:
            type: string
          description: >-
            A machine-readable structure to reference to the exact location(s)
            causing the error(s)
          nullable: true
        stackTrace:
          type: string
          nullable: true
        title:
          type: string
          description: A short human-readable description of the problem type
          nullable: true
        traceId:
          type: string
          description: The request correlation ID this problem comes from.
          nullable: true
        traceIdentifier:
          type: string
          description: >-
            The request correlation ID this problem comes from. (deprecated, use
            traceId instead)
          nullable: true
        type:
          enum:
            - unknown
            - access-control
            - authentication
            - authorization
            - availability
            - deprecation
            - quota
            - validation
          type: string
          description: The problem's category.
          nullable: true
      description: Common problem object.
    LineItemDetails:
      required:
        - core
      type: object
      properties:
        adContent:
          $ref: '#/components/schemas/LineItemAdContentDetails'
        bidding:
          $ref: '#/components/schemas/BiddingSettings'
        core:
          $ref: '#/components/schemas/ExternalLineItem'
        targeting:
          $ref: '#/components/schemas/LineItemTargetingDetails'
      additionalProperties: false
      description: A consolidated view of a line item and its details.
      nullable: true
    LineItemAdContentDetails:
      type: object
      properties:
        creatives:
          $ref: '#/components/schemas/LineItemCreatives'
        products:
          $ref: '#/components/schemas/ProductsModel'
      additionalProperties: false
      description: Ad-content details associated with a line item.
      nullable: true
    BiddingSettings:
      type: object
      properties:
        cpm:
          $ref: '#/components/schemas/CpmBiddingSettings'
      additionalProperties: false
      description: Represents the bidding configuration for a line item.
      nullable: true
    ExternalLineItem:
      type: object
      properties:
        budgetStatus:
          enum:
            - Unknown
            - BudgetAvailable
            - DailyBudgetReached
            - MonthlyBudgetReached
            - TotalBudgetReached
          type: string
          description: Indicates whether the line item has budget headroom to serve ads.
          nullable: true
        campaignId:
          type: string
          description: The campaign id of the associated campaign.
          nullable: true
        conquestingSettings:
          $ref: '#/components/schemas/ExternalConquestingSettings'
        effectiveFlightDates:
          $ref: '#/components/schemas/ExternalFlightDatesModel'
        isPaused:
          type: boolean
          description: Indicates whether the line item is paused.
          nullable: true
        lineItemId:
          type: string
          description: The unique identifier of the line item.
          nullable: true
        name:
          type: string
          description: The name of the line item.
          nullable: true
        onsiteDisplayDetails:
          $ref: '#/components/schemas/OnsiteDisplayLineItemDetails'
        retailerId:
          type: string
          description: The retailer id of the associated retailer.
          nullable: true
        serveToOptOutUser:
          type: boolean
          description: >-
            Whether ads are served to users who have opted out of
            personalization.
          nullable: true
        type:
          enum:
            - Unknown
            - SponsoredProduct
            - OnsiteDisplay
          type: string
          description: The type of the line item.
          nullable: true
      additionalProperties: false
      description: "A unit of ad delivery configuration within a campaign. It defines how a specific subset of ads\r\nis targeted."
      nullable: true
    LineItemTargetingDetails:
      required:
        - targets
      type: object
      properties:
        targets:
          type: array
          items:
            $ref: '#/components/schemas/Target'
          description: Targets associated with the line item.
      additionalProperties: false
      description: Targeting details associated with a line item.
      nullable: true
    LineItemCreatives:
      required:
        - creatives
      type: object
      properties:
        creatives:
          type: array
          items:
            $ref: '#/components/schemas/LineItemCreative'
          description: The creatives associated with the line item.
        mediaType:
          enum:
            - Unknown
            - Display
            - Video
          type: string
          description: The media type of the associated creatives, if known.
          nullable: true
      additionalProperties: false
      description: Creatives associated with a line item.
      nullable: true
    ProductsModel:
      type: object
      properties:
        displayProductDetails:
          type: array
          items:
            $ref: '#/components/schemas/DisplayProductDetailModel'
          description: The display product details.
          nullable: true
        productType:
          enum:
            - Unknown
            - DisplayProduct
            - SponsoredProduct
          type: string
          description: The type of products.
          nullable: true
        sponsoredProductDetails:
          type: array
          items:
            $ref: '#/components/schemas/SponsoredProductDetailModel'
          description: The sponsored product details.
          nullable: true
      additionalProperties: false
      description: Products associated with a line item.
      nullable: true
    CpmBiddingSettings:
      required:
        - bidStrategy
      type: object
      properties:
        adaptiveBiddingSettings:
          $ref: '#/components/schemas/AdaptiveBiddingSettings'
        bidStrategy:
          enum:
            - Standard
            - Adaptive
          type: string
          description: The active bidding strategy for the line item.
        standardBiddingSettings:
          $ref: '#/components/schemas/StandardBiddingSettings'
      additionalProperties: false
      description: Represents the bidding configuration for a CPM-based line item.
      nullable: true
    ExternalConquestingSettings:
      required:
        - conquestingAdStrategyEnabled
        - defensiveAdStrategyEnabled
        - isAdStrategyLocked
        - neutralAdStrategyEnabled
      type: object
      properties:
        conquestingAdStrategyEnabled:
          type: boolean
          description: >-
            Whether the line item may bid on competitors' branded keywords.
            Defaults to false.
        defensiveAdStrategyEnabled:
          type: boolean
          description: >-
            Whether the line item may bid on the advertiser's own branded
            keywords. Defaults to true.
        isAdStrategyLocked:
          type: boolean
          description: >-
            Whether the keyword strategy flags have been set and can no longer
            be changed.
        neutralAdStrategyEnabled:
          type: boolean
          description: >-
            Whether the line item may bid on generic, unbranded category
            keywords. Defaults to true.
      additionalProperties: false
      description: Which categories of search keyword the line item is eligible to bid on.
      nullable: true
    ExternalFlightDatesModel:
      type: object
      properties:
        endDate:
          type: string
          description: When the line item expires.
          format: date-time
          nullable: true
        startDate:
          type: string
          description: When the line item becomes active.
          format: date-time
          nullable: true
      additionalProperties: false
      description: Active date range for a line item.
      nullable: true
    OnsiteDisplayLineItemDetails:
      type: object
      properties:
        auctionDetails:
          $ref: '#/components/schemas/OnsiteDisplayAuctionLineItemDetails'
        frequencyCapping:
          $ref: '#/components/schemas/ExternalFrequencyCappingModel'
      additionalProperties: false
      description: Settings that only apply to onsite display line items.
      nullable: true
    Target:
      type: object
      properties:
        approvalStatus:
          enum:
            - Unknown
            - Approved
            - AutoApproved
            - InReview
            - Rejected
            - AutoRejected
            - Unsubmitted
          type: string
          nullable: true
        bidMultiplier:
          type: number
          format: double
          nullable: true
        categoryTargetDetails:
          $ref: '#/components/schemas/CategoryTargetDetails'
        geographyTargetDetails:
          $ref: '#/components/schemas/GeographyTargetDetails'
        manualKeywordTargetDetails:
          $ref: '#/components/schemas/ManualKeywordTargetDetails'
        negative:
          type: boolean
          nullable: true
        pageTypeTargetDetails:
          $ref: '#/components/schemas/PageTypeTargetDetails'
        targetType:
          enum:
            - Unknown
            - ManualKeyword
            - PageType
            - Category
            - Geography
          type: string
          nullable: true
      additionalProperties: false
      description: A specific Target configured on the line item
    LineItemCreative:
      required:
        - approvalStatus
        - creative
        - creativeProductCollections
      type: object
      properties:
        approvalStatus:
          enum:
            - Unknown
            - Approved
            - AutoApproved
            - InReview
            - Rejected
            - AutoRejected
            - Unsubmitted
          type: string
        creative:
          $ref: '#/components/schemas/Creative'
        creativePreviewCode:
          type: string
          nullable: true
        creativeProductCollections:
          type: array
          items:
            $ref: '#/components/schemas/CreativeProductCollection'
      additionalProperties: false
      description: The association between a line item and one of its creatives.
    DisplayProductDetailModel:
      type: object
      properties:
        approvalStatus:
          enum:
            - Unknown
            - Approved
            - AutoApproved
            - InReview
            - Rejected
            - AutoRejected
            - Unsubmitted
          type: string
          description: The approval status of the product.
          nullable: true
        productId:
          type: string
          description: The identifier of the product.
          nullable: true
      additionalProperties: false
      description: A display product associated with a line item.
    SponsoredProductDetailModel:
      type: object
      properties:
        productId:
          type: string
          description: The identifier of the product.
          nullable: true
        status:
          enum:
            - Active
            - Inactive
            - Expired
            - Removed
            - Deleted
          type: string
          description: The status of the product in the line item's product pool.
          nullable: true
      additionalProperties: false
      description: A sponsored product associated with a line item.
    AdaptiveBiddingSettings:
      type: object
      properties:
        maxBid:
          type: number
          description: The maximum bid that the Adaptive strategy may use.
          format: double
          nullable: true
      additionalProperties: false
      description: >-
        Represents the bidding settings used when the active strategy is
        Adaptive.
      nullable: true
    StandardBiddingSettings:
      required:
        - auctionBids
      type: object
      properties:
        auctionBids:
          type: array
          items:
            $ref: '#/components/schemas/LineItemAuctionBid'
          description: The manual bid amounts configured per page type.
      additionalProperties: false
      description: >-
        Represents the bidding settings used when the active strategy is
        Standard.
      nullable: true
    OnsiteDisplayAuctionLineItemDetails:
      type: object
      properties:
        isDynamicMatch:
          type: boolean
          description: >-
            Whether only products relevant to the page context serve, replacing
            manual SKU curation.
          nullable: true
      additionalProperties: false
      description: Settings that only apply to auction-bought onsite display line items.
      nullable: true
    ExternalFrequencyCappingModel:
      type: object
      properties:
        cappingCount:
          type: integer
          description: How many times the ads may be shown within the duration.
          format: int32
          nullable: true
        cappingDurationType:
          enum:
            - Unknown
            - Session
            - Day
          type: string
          description: The period the count applies to.
          nullable: true
      additionalProperties: false
      description: How often a single user may be shown the line item's ads.
      nullable: true
    CategoryTargetDetails:
      type: object
      properties:
        categoryId:
          type: string
          nullable: true
        includeChildren:
          type: boolean
          nullable: true
      additionalProperties: false
      description: Details on Category Targets
      nullable: true
    GeographyTargetDetails:
      type: object
      properties:
        geoLocationId:
          type: string
          nullable: true
      additionalProperties: false
      description: Details on Geography Targets
      nullable: true
    ManualKeywordTargetDetails:
      type: object
      properties:
        keywordInput:
          maxLength: 255
          minLength: 1
          type: string
          nullable: true
        matchType:
          enum:
            - Broad
            - Exact
          type: string
          nullable: true
      additionalProperties: false
      description: Details on Manual Keyword Targets
      nullable: true
    PageTypeTargetDetails:
      type: object
      properties:
        pageType:
          enum:
            - Unknown
            - Search
            - Home
            - Browse
            - Checkout
            - Category
            - ProductDetail
            - Confirmation
            - Merchandising
            - Deals
            - Favorites
            - SearchBar
            - CategoryMenu
            - AiAssistant
          type: string
          description: "Contract representation of pagetype Ids supplied by Inventory API.\r\nThis enum re-exposes those persisted byte IDs as typed values for target-service clients."
          nullable: true
      additionalProperties: false
      description: Details on Page Type Targets
      nullable: true
    Creative:
      required:
        - id
        - modifiedAt
      type: object
      properties:
        id:
          type: string
        modifiedAt:
          type: string
          format: date-time
      additionalProperties: false
      description: A reference to a creative associated with a line item.
    CreativeProductCollection:
      required:
        - isMandatory
        - products
      type: object
      properties:
        isMandatory:
          type: boolean
        products:
          type: array
          items:
            $ref: '#/components/schemas/DisplayProduct'
      additionalProperties: false
      description: A collection of products associated with a creative.
    LineItemAuctionBid:
      required:
        - bid
        - pageType
      type: object
      properties:
        bid:
          type: number
          description: The bid amount in the line item's currency.
          format: double
        pageType:
          enum:
            - Unknown
            - Search
            - Home
            - Browse
            - Checkout
            - Category
            - ProductDetail
            - Confirmation
            - Merchandising
            - Deals
            - Favorites
            - SearchBar
            - CategoryMenu
            - AiAssistant
          type: string
          description: The page type to which this bid applies.
      additionalProperties: false
      description: Represents a manual bid amount for a single page type.
    DisplayProduct:
      required:
        - approvalStatus
        - id
      type: object
      properties:
        approvalStatus:
          enum:
            - Unknown
            - Approved
            - AutoApproved
            - InReview
            - Rejected
            - AutoRejected
            - Unsubmitted
          type: string
        id:
          type: string
      additionalProperties: false
      description: A product in a creative's product collection.
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            RetailMedia_Accounts_Read: >-
              Grants Read access to the capabilities from the Accounts domain,
              for RetailMedia applications
            RetailMedia_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for RetailMedia applications
            RetailMedia_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for RetailMedia applications
            RetailMedia_Balance_Read: >-
              Grants Read access to the capabilities from the Balance domain,
              for RetailMedia applications
            RetailMedia_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for RetailMedia applications
            RetailMedia_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for RetailMedia applications
            RetailMedia_OnSiteRecommendation_Read: >-
              Grants Read access to the capabilities from the
              OnSiteRecommendation domain, for RetailMedia applications
            RetailMedia_ThirdPartyAccounts_Manage: >-
              Grants Manage access to the capabilities from the
              ThirdPartyAccounts domain, for RetailMedia applications
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            RetailMedia_Accounts_Read: >-
              Grants Read access to the capabilities from the Accounts domain,
              for RetailMedia applications
            RetailMedia_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for RetailMedia applications
            RetailMedia_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for RetailMedia applications
            RetailMedia_Balance_Read: >-
              Grants Read access to the capabilities from the Balance domain,
              for RetailMedia applications
            RetailMedia_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for RetailMedia applications
            RetailMedia_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for RetailMedia applications
            RetailMedia_OnSiteRecommendation_Read: >-
              Grants Read access to the capabilities from the
              OnSiteRecommendation domain, for RetailMedia applications
            RetailMedia_ThirdPartyAccounts_Manage: >-
              Grants Manage access to the capabilities from the
              ThirdPartyAccounts domain, for RetailMedia applications

````