---
updatedAt: 2026-05-28T21:10:23.000Z
agentTools:
  projectIndex: https://docs.hivestack.com/llms.txt
---

# Returns a list of lineitem-deal-creative associations.

This endpoint returns a list of `lineitem-deals-creative` objects. The `lineitem-deals-creative` object represents the link between a line item, a deal and a creative. The results can optionally be filtered by `lineitem_id` and `creative_id`, with a maximum of 100 objects returned. If no associations are found, the endpoint will return an empty list (`[]`).

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Campaigns",
    "description": "Campaigns management and data pushes",
    "version": "2",
    "contact": {
      "email": "support@perion.com"
    }
  },
  "servers": [
    {
      "url": "https://apps.hivestack.com/api/v2"
    }
  ],
  "security": [
    {
      "hs-auth": []
    }
  ],
  "paths": {
    "/lineitemdealcreatives": {
      "get": {
        "tags": [
          "LineItem-Deal-Creative Associations"
        ],
        "summary": "Returns a list of lineitem-deal-creative associations.",
        "description": "This endpoint returns a list of `lineitem-deals-creative` objects. The `lineitem-deals-creative` object represents the link between a line item, a deal and a creative. The results can optionally be filtered by `lineitem_id` and `creative_id`, with a maximum of 100 objects returned. If no associations are found, the endpoint will return an empty list (`[]`).",
        "parameters": [
          {
            "$ref": "#/components/parameters/top"
          },
          {
            "$ref": "#/components/parameters/skip"
          },
          {
            "name": "lineitem_id",
            "in": "query",
            "required": false,
            "description": "Auto generated Perion DOOH line item unique identifier. If included, the endpoint will return the associations between a line item, a deal, and a creative that contain the provided `lineitem_id`.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "creative_id",
            "in": "query",
            "required": false,
            "description": "Auto generated Perion DOOH creative unique identifier. If included, the endpoint will return the associations between a line item, a deal, and a creative that contain the provided `creative_id`.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK - The list of lineitem deal creatives was retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "creative_id": {
                        "type": "integer",
                        "example": "111",
                        "description": "The unique creative id."
                      },
                      "lineitem_id": {
                        "type": "integer",
                        "example": "111",
                        "description": "The unique lineitem id."
                      },
                      "deal_id": {
                        "type": "string",
                        "example": "abCDe-1234",
                        "description": "The deal_id lineitem id."
                      },
                      "deal_flight_from": {
                        "type": "string",
                        "example": "2021-12-03",
                        "description": "The date at which the deal starts."
                      },
                      "deal_flight_to": {
                        "type": "string",
                        "example": "2021-12-04",
                        "description": "The date at which the deal stops."
                      },
                      "local_from_date": {
                        "type": "string",
                        "example": "2021-12-03",
                        "description": "The date at which the creative will start flighting."
                      },
                      "local_to_date": {
                        "type": "string",
                        "example": "2021-12-04",
                        "description": "The date at which the creative will stop flighting."
                      }
                    }
                  },
                  "example": [
                    {
                      "creative_id": 333,
                      "lineitem_id": 111,
                      "deal_id": "abCDe-1234",
                      "deal_flight_from": "2022-01-01",
                      "deal_flight_to": "2022-01-04",
                      "local_from_date": "2022-01-01",
                      "local_to_date": "2022-01-04"
                    },
                    {
                      "creative_id": 334,
                      "lineitem_id": 112,
                      "deal_id": "fGhIJ-4523",
                      "deal_flight_from": "2022-01-01",
                      "deal_flight_to": "2022-01-04",
                      "local_from_date": "2022-01-01",
                      "local_to_date": "2022-01-04"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequestResponse"
          },
          "401": {
            "$ref": "#/components/responses/UnauthorizedError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "hs-auth": {
        "type": "apiKey",
        "name": "hs-auth",
        "in": "header",
        "description": "The value should follow the following format: `apikey access_key:secret_key`"
      }
    },
    "responses": {
      "UnauthorizedError": {
        "description": "API key is missing or invalid. Please contact support@perion.com.",
        "headers": {
          "hs-auth": {
            "description": "Set the hs-auth header following this pattern `apikey your_access_key:your_secret_key`",
            "schema": {
              "type": "string"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "example": "Missing authorization info"
                }
              }
            }
          }
        }
      },
      "BadRequestResponse": {
        "description": "400 Bad Request response status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing)."
      }
    },
    "parameters": {
      "top": {
        "name": "$top",
        "in": "query",
        "description": "The number of items to return (max 100)",
        "required": false,
        "schema": {
          "type": "integer",
          "example": 100,
          "default": 100
        }
      },
      "skip": {
        "name": "$skip",
        "in": "query",
        "required": false,
        "description": "The number of items to skip before starting to collect the result set.",
        "schema": {
          "type": "integer",
          "example": 0,
          "default": 0
        }
      }
    }
  }
}
```