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

# Get a content item

> Retrieves a detailed representation of a content item. The content item can be looked up either by its internal identifier (id)
or by an external system identifier (externalId).
At least one of the parameters must be provided.



## OpenAPI

````yaml openapi/feed-v1.json GET /v1/Content
openapi: 3.0.4
info:
  title: Feed.Api
  version: v1
servers:
  - url: https://{host}/feed
    description: Your Lobyco environment
    variables:
      host:
        default: your-environment.lobyco.net
        description: >-
          The API host for your Lobyco environment. Replace it with the host you
          were given — this placeholder does not resolve.
security:
  - Bearer: []
paths:
  /v1/Content:
    get:
      tags:
        - S2S
      summary: Get a content item
      description: >-
        Retrieves a detailed representation of a content item. The content item
        can be looked up either by its internal identifier (id)

        or by an external system identifier (externalId).

        At least one of the parameters must be provided.
      parameters:
        - name: id
          in: query
          description: >-
            The internal unique identifier of the content item (optional if
            externalId is provided).
          schema:
            type: integer
            format: int64
        - name: externalId
          in: query
          description: >-
            An external system identifier for the content item (optional if id
            is provided).
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Feed.Api.DTO.ContentItem'
            application/json:
              schema:
                $ref: '#/components/schemas/Feed.Api.DTO.ContentItem'
            text/json:
              schema:
                $ref: '#/components/schemas/Feed.Api.DTO.ContentItem'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails'
components:
  schemas:
    Feed.Api.DTO.ContentItem:
      type: object
      properties:
        id:
          type: integer
          description: Internal unique identifier of the content item.
          format: int64
        campaignName:
          type: string
          description: Name of the content to be easily identified.
          nullable: true
        title:
          type: string
          description: Title of the content item.
          nullable: true
        feedType:
          $ref: '#/components/schemas/Feed.Api.DTO.FeedType'
        contentType:
          $ref: '#/components/schemas/Feed.Api.DTO.ContentType'
        status:
          $ref: '#/components/schemas/Feed.Api.DTO.ContentStatus'
        analyticsIdentifier:
          type: string
          description: Tracking identifier used for analytics.
          nullable: true
        publishDate:
          type: string
          description: The date and time when the content should be published.
          format: date-time
          nullable: true
        expirationDate:
          type: string
          description: >-
            The date and time when the content expires and should no longer be
            displayed.
          format: date-time
          nullable: true
        imageUrl:
          type: string
          description: URL of the image displayed in the content item.
          nullable: true
        altText:
          type: string
          description: Alternative text describing the image, used for accessibility.
          nullable: true
        videoUrl:
          type: string
          description: URL of the video displayed in the content item.
          nullable: true
        topMessage:
          type: string
          description: Short message displayed at the top of the content.
          nullable: true
        bottomMessage:
          type: string
          description: Short message displayed at the bottom of the content.
          nullable: true
        longDescription:
          type: string
          description: Message displayed when the content type is text.
          nullable: true
        buttonText:
          type: string
          description: Text displayed on the action button.
          nullable: true
        navigationType:
          $ref: '#/components/schemas/Feed.Api.DTO.NavigationType'
        externalUrl:
          type: string
          description: External URL to be opened when button is clicked.
          nullable: true
        useWebWrapper:
          type: boolean
          description: >-
            Indicates whether the external content should be opened in a web
            wrapper.
          nullable: true
        deepLinkId:
          type: string
          description: >-
            Deep link identifier. Used to open a specific page from the
            application when button is clicked.
          nullable: true
        deepLinkParameters:
          type: object
          additionalProperties:
            type: string
          description: >-
            Additional parameters for deep link. (e.g. redirect user to a
            specific entity from the section configured with DeepLinkId)
          nullable: true
        deepLinkUrl:
          type: string
          description: Deep link URL for navigation.
          nullable: true
        isReadyToDistribute:
          type: boolean
          description: Indicates whether the content is ready to be distributed.
        isSegmented:
          type: boolean
          description: |-
            Obsolete: Indicates whether the content is segmented. 
            Use Feed.Api.DTO.ContentItem.SegmentationType instead.
          deprecated: true
        segmentationType:
          $ref: '#/components/schemas/Feed.Api.DTO.SegmentationType'
        segmentationFiles:
          type: array
          items:
            $ref: '#/components/schemas/Feed.Api.DTO.SegmentationFile'
          description: Collection of segmentation files associated with the content.
          nullable: true
        authorId:
          type: string
          description: Identifier of the content's author.
          nullable: true
        authorName:
          type: string
          description: Name of the content's author.
          nullable: true
        createdDate:
          type: string
          description: Date and time when the content was created.
          format: date-time
        modifiedDate:
          type: string
          description: Date and time when the content was last modified.
          format: date-time
        membersCount:
          type: integer
          description: Number of members associated with the content.
          format: int32
        fileName:
          type: string
          description: File name associated with the content (if any).
          nullable: true
        fileSize:
          type: number
          description: Size of the associated file in bytes.
          format: double
        externalId:
          type: string
          description: External identifier for the content.
          nullable: true
        storeId:
          type: string
          description: Identifier of the store targeted by this content.
          nullable: true
          deprecated: true
        audienceIds:
          type: array
          items:
            type: string
          description: List of audience identifiers targeted by this content.
          nullable: true
        chainIds:
          type: array
          items:
            type: string
          description: List of chain identifiers targeted by this content.
          nullable: true
        storeIds:
          type: array
          items:
            type: string
          description: List of store identifiers targeted by this content.
          nullable: true
        isBoardContent:
          type: boolean
          description: Client specific property used for custom integration.
          nullable: true
        placeholders:
          type: array
          items:
            type: string
          description: List of placeholders defined for this content.
          nullable: true
        customProperties:
          type: object
          additionalProperties: {}
          description: Dictionary of custom properties.(e.g. logoUrl, terms)
          nullable: true
        disablingReasons:
          type: array
          items:
            $ref: '#/components/schemas/Feed.Api.DTO.ContentDisablingReason'
          description: Reasons why the content may be disabled.
          nullable: true
        priority:
          type: integer
          description: Priority with which the content is displayed in the application.
          format: int32
          nullable: true
        openedCount:
          type: integer
          description: >-
            Number of times the content has been clicked and the user is either
            redirected accordingly to the configured navigation or the feed is
            expanded.
          format: int64
        requiresApproval:
          type: boolean
          description: >-
            Indicates whether the content requires approval before being
            published.
        unifiedCampaignId:
          type: string
          description: Unified campaign identifier associated with the content item
          nullable: true
        validForDays:
          type: integer
          description: >-
            Validity period in days for the content item. The validity period is
            calculated starting from the allocation date. This property is only
            applicable for content items with Customer Segmentation Type.
          format: int32
          nullable: true
      additionalProperties: false
    Microsoft.AspNetCore.Mvc.ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
      additionalProperties: {}
    Feed.Api.DTO.FeedType:
      enum:
        - Inspiration
        - Purchase
        - GreenNews
        - StoreOffer
        - StoreNews
        - StoreSpecial
        - GoodPrice
        - WeeklyGoodPrice
        - Survey
        - Event
        - SpecialPoll
        - PartnerBenefit
        - PartnerBenefitBanner
      type: string
    Feed.Api.DTO.ContentType:
      enum:
        - Image
        - Video
        - Text
      type: string
    Feed.Api.DTO.ContentStatus:
      enum:
        - Draft
        - Scheduled
        - Published
        - Expired
        - Disabled
      type: string
    Feed.Api.DTO.NavigationType:
      enum:
        - External
        - DeepLink
      type: string
    Feed.Api.DTO.SegmentationType:
      enum:
        - None
        - Audience
        - Customer
        - File
      type: string
    Feed.Api.DTO.SegmentationFile:
      required:
        - customerCount
        - name
        - size
        - url
      type: object
      properties:
        url:
          type: string
          description: URL to access the segmentation file.
          nullable: true
        name:
          type: string
          description: Name of the segmentation file.
          nullable: true
        size:
          type: integer
          description: Size of the segmentation file.
          format: int64
        customerCount:
          type: integer
          description: Number of members included in this segmentation.
          format: int32
      additionalProperties: false
    Feed.Api.DTO.ContentDisablingReason:
      type: object
      properties:
        date:
          type: string
          description: Date at which the feed was disabled.
          format: date-time
        reason:
          type: string
          description: Description of disabling reason.
          nullable: true
        imageUrls:
          type: array
          items:
            type: string
          description: Collection of image URLs attached for the disable action.
          nullable: true
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: apiKey
      description: >-
        Opaque Authorization header using the Bearer scheme. Example:
        "Authorization: Bearer {token}"
      name: Authorization
      in: header

````