Skip to content

GET /api/v3/campaigns/{lcuid}/inventory-items

Summary

GET campaigns/{lcuid}/inventory-items

Description

Get a list of inventory-items that are currently attached to this campaign.

Tags: campaigns

Parameters

Header Parameters

Name Type Required Description Example
Authorization string ✓ Yes Bearer {AuthToken}
Content-Type string ✓ Yes application/json
Accept string ✓ Yes application/json
AppIdV3 string ✓ Yes LCUID-LAP-********-****-****-****-************

Responses

Response: 200

Description: Sample Response

Content Type: application/json

Schema

Type: object

Properties:

  • success (boolean)
  • inventory_items (array)

  • Array items: object Type: object

    Properties:

    • unique_id (string)
    • title (string)
    • description (string)
    • new_used (integer)
    • year (string)
    • make (string)
    • model (string)
    • sub_model (string)
    • price (integer)
    • price_original (string)
    • price_modifier (string)
    • external_link (string)
    • status (integer)
    • item_class (string)
    • creative_state (integer)
    • lcuid (string)
    • created_at (string)
    • updated_at (string)
    • deleted_at (string)
    • has_price_override (boolean)
    • price_upstream (string)
    • creatives (array)

    • Array items: object Type: object

      Properties:

      • order_number (integer)
      • status (integer)
      • unique_hash (string)
      • lcuid (string)
      • hash_id (string)
      • options (object) Type: object

      Properties:

      • size_in_bytes (string)
      • dimension_height (integer)
      • dimension_width (integer)
      • hash_md5 (string)

      • public_url (string)

      • xr_status (integer)

      • drive_template_id (string)

    • options (object) Type: object

    Properties:

    • best_creative_image_photo_url (string)
    • first_play_at (string)
    • primary_image_background_removed_public_url (string)

    • primary_image_public_url (string)

    • cached_tags (string)

    • attributes (array)
    • data_source (object) Type: object

    Properties:

    • lcuid (string)

    • name (string)

    • campaign_settings (string)

Example Response
{
    "success": true,
    "inventory_items": [
        {
            "unique_id": "9AAzmMZBKz",
            "title": "Some Item 0",
            "description": "Some Description - NVgRnloCiPgjIv7ZnFuAThHQvmJfKFSKZFjWejpf0Wl6NPM8dmpvBQxzMEBTukBQEzAR3ubp8dk3Tkwnh2QVw7Qim9dIXhg06NUf1X1fcoSdQluGpi6dex1d601kdrxgC0DZoOeUzyZYG1BbirGPm2",
            "new_used": 0,
            "year": null,
            "make": "Some Make",
            "model": "Some Model",
            "sub_model": "Some Sub Model",
            "price": 1087,
            "price_original": "1087.00",
            "price_modifier": null,
            "external_link": "https://www.example.com/9AAzmMZBKz",
            "status": 1,
            "item_class": "App\\LuCore\\InventoryItems\\RealEstateInventoryItemClass",
            "creative_state": 2,
            "lcuid": "LCUID-LI-1ff16da8-5dd9-4791-99e3-5b02cd0ef34e",
            "created_at": "2026-10-09T13:49:21.000000Z",
            "updated_at": "2026-10-09T13:49:25.000000Z",
            "deleted_at": null,
            "has_price_override": false,
            "price_upstream": null,
            "creatives": [
                {
                    "order_number": 90,
                    "status": 1,
                    "unique_hash": "0ef8f52c898bfb362c96e4e5e49e42a1",
                    "lcuid": "LCUID-LP-aa415edd-8b10-4e24-9421-07e26d837d19",
                    "hash_id": "lch-4N4u",
                    "options": {
                        "size_in_bytes": null,
                        "dimension_height": 180,
                        "dimension_width": 560,
                        "hash_md5": "c82834b7e7c8688e843d37abf3e6ef49",
                        "public_url": "http://localhost:8080/storage/13/40223/img_6ac8f0e4c41cc_06366594c13123fd2905.jpg"
                    },
                    "xr_status": 1,
                    "drive_template_id": "LCUID-LDT-8c9a465d-54ae-41c4-af0a-729cf3c08990"
                }
            ],
            "options": {
                "best_creative_image_photo_url": null,
                "first_play_at": null,
                "primary_image_background_removed_public_url": null,
                "primary_image_public_url": "http://localhost:8080/storage/13/40223/img_6ac8f0e22afe7_9e3c9c556ba6a3a866e2.png"
            },
            "cached_tags": null,
            "attributes": [],
            "data_source": {
                "lcuid": "LCUID-LF-c5b223dc-87b4-4f97-b1b1-e4f01d210449",
                "name": "LC MLS System"
            },
            "campaign_settings": null
        },
        {
            "unique_id": "0pYc2A81B3",
            "title": "Some Item 1",
            "description": "Some Description - hTGhoOhVOLmU9Ng3bUAxsgbTfqOIqf1JD8OF5dbfK8Dkumdcgdz3TyUSfcZnwdg2L8YpINf1jrCFvYvUaKG3U83d2phsTydkjtAsJuZ2gX1Li6IaZcCSbOkmodc6jZD4LxdC7M2c0NIJZqdxwNl5vh",
            "new_used": 0,
            "year": null,
            "make": "Some Make",
            "model": "Some Model",
            "sub_model": "Some Sub Model",
            "price": 6030,
            "price_original": "6030.00",
            "price_modifier": null,
            "external_link": "https://www.example.com/0pYc2A81B3",
            "status": 1,
            "item_class": "App\\LuCore\\InventoryItems\\RealEstateInventoryItemClass",
            "creative_state": 2,
            "lcuid": "LCUID-LI-a178010b-dd4f-4418-a479-9655863d5b12",
            "created_at": "2026-10-09T13:49:22.000000Z",
            "updated_at": "2026-10-09T13:49:25.000000Z",
            "deleted_at": null,
            "has_price_override": false,
            "price_upstream": null,
            "creatives": [
                {
                    "order_number": 90,
                    "status": 1,
                    "unique_hash": "08bc54e78f2c3a37213b1414e305b94f",
                    "lcuid": "LCUID-LP-aba76cb8-daea-49f6-ad79-a331635b8d55",
                    "hash_id": "lch-4N4v",
                    "options": {
                        "size_in_bytes": null,
                        "dimension_height": 180,
                        "dimension_width": 560,
                        "hash_md5": "c82834b7e7c8688e843d37abf3e6ef49",
                        "public_url": "http://localhost:8080/storage/13/40224/img_6ac8f0e52f427_1aa9b7357d7b399bccda.jpg"
                    },
                    "xr_status": 1,
                    "drive_template_id": "LCUID-LDT-8c9a465d-54ae-41c4-af0a-729cf3c08990"
                }
            ],
            "options": {
                "best_creative_image_photo_url": null,
                "first_play_at": null,
                "primary_image_background_removed_public_url": null,
                "primary_image_public_url": "http://localhost:8080/storage/13/40224/img_6ac8f0e2ce670_fef3d40a6c95bfd5d230.png"
            },
            "cached_tags": null,
            "attributes": [],
            "data_source": {
                "lcuid": "LCUID-LF-c5b223dc-87b4-4f97-b1b1-e4f01d210449",
                "name": "LC MLS System"
            },
            "campaign_settings": null
        }
    ]
}

Example Implementations

Bash (cURL)

curl --request GET \
    --get "https://api.lucit.app/api/v3/campaigns/LCUID-LE-506fc585-77be-11ec-acb9-c2cdb617d190/inventory-items" \
    --header "Authorization: Bearer {AuthToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "AppIdV3: LCUID-LAP-********-****-****-****-************"

JavaScript (Fetch API)

const url = new URL(
    "https://api.lucit.app/api/v3/campaigns/LCUID-LE-506fc585-77be-11ec-acb9-c2cdb617d190/inventory-items"
);

const headers = {
    "Authorization": "Bearer {AuthToken}",
    "Content-Type": "application/json",
    "Accept": "application/json",
    "AppIdV3": "LCUID-LAP-********-****-****-****-************",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

PHP (Guzzle)

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://api.lucit.app/api/v3/campaigns/LCUID-LE-506fc585-77be-11ec-acb9-c2cdb617d190/inventory-items',
    [
        'headers' => [
            'Authorization' => 'Bearer {AuthToken}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'AppIdV3' => 'LCUID-LAP-********-****-****-****-************',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Python (Requests)

import requests
import json

url = 'https://api.lucit.app/api/v3/campaigns/LCUID-LE-506fc585-77be-11ec-acb9-c2cdb617d190/inventory-items'
headers = {
  'Authorization': 'Bearer {AuthToken}',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'AppIdV3': 'LCUID-LAP-********-****-****-****-************'
}

response = requests.request('GET', url, headers=headers)
response.json()

← Back to campaigns index | Back to main index