Product

The Products resource allows you to retrieve and manage individual products within the Lumytic platform. Products are the most granular items in the product hierarchy and contain detailed attributes, descriptions, and relationships to their family, category, and series.

Learn more about product management.

Get Published Products

Retrieves all published products within a specific product family. This endpoint is useful for displaying detailed product information in catalogs, dashboards, or external integrations. It ensures that only products marked as published are returned.

Endpoint:

GET

/product_development/v1/products?product_family_id={product_family_id}

Query Parameters (Optional):

Parameter	Type	Description	Example
product_family_id	integer	Filter products by a specific family.	../products?product_family_id=52

Request Example

    curl -X GET "https://api.lumytic.com/product_development/v1/products?product_family_id=52“\
    
    -H "ApiKey: YOUR_API_KEY_HERE" \
    
    -H "Content-Type: application/json"

    -H "Accept-Language: en"

Response Example

{
    "success": true,
    "message": "All collection fetched successfully.",
    "data": {
        "collection": [
            {
                "ID": "49440",
                "weight": null,
                "CRI": "70",
                "Multiple_ip": "0",
                "Front_ip": null,
                "Back_ip": null,
                "IP": "67",
                "IK": "8",
                "Power_up": "0",
                "Power": "300",
                "Current": null,
                "frequency": null,
                "Lumen": "41053",
                "PowerFactor": null,
                "warranty": "5",
                "lifespan": "50000",
                "reference_code": null,
                "product_number": "P2-FDL-VEG300-04-025092",
                "Firerated": "0",
                "Firerated_value": null,
                "labels": null,
                "product_status": "Continued",
                "barcode": null,
                "zoomable": null,
                "zoomable_value": null,
                "Phases": null,
                "Wires": null,
                "Radius": "350",
                "Length": null,
                "Height": "100",
                "Width": null,
                "Family_name": "Vega",
                "cat_name": "Floodlight",
                "family_shortcut_code": "VE",   
                "description": "Vega - Floodlight <b style=\"font-weight: bold;\"></b> Recessed, Mounted on pole, Surface <b style=\"font-weight: bold;\">300 4000K</b> -  70 41053 - -IP 67 - <b style=\"font-weight: bold;\">Shanahan, Dare and Schulist LED </b><b style=\"font-weight: bold;\">Rectangular  W372 x L481 x H71</b> BLACK / Die-cast aluminum (Housing)  - <b style=\"font-weight: bold;\"
                "photo_url": " https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/507/{image_name}.jpg ",
                "datasheet_url": null,
                "CCT_values": "4000",
                "Beam_angle": "30 - 0",
                "input_voltage": "-",
                "WorkingTemperature": "-",
                "qty_ctn": "12",
                "ctn_size_cbm": "W39 x L51.5 x H35",
                "ctn_volume": 0.0702975,
                "symbol": "$",
                "liminous_efficiency": "136.843lm/w",
                "dimension": "Rectangular  W372 x L481 x H71",
                "cut_out": null,
                "time_diff": "1321 days"
            },
            {
                "ID": "49439",
                "weight": null,
                "CRI": "70",
                "Multiple_ip": "0",
                "Front_ip": null,
                "Back_ip": null,
                "IP": "67",
                "IK": "8",
                "Power_up": "0",
                "Power": "240",
                "Current": null,
                "frequency": null,
                "Lumen": "32842",
                "PowerFactor": null,
                "warranty": "5",
                "lifespan": "50000",
                "reference_code": null,
                "product_number": "P2-FDL-VEG240-04-025075",
                "Firerated": "0",
                "Firerated_value": null,
                "labels": null,
                "product_status": "Continued",
                "barcode": null,
                "zoomable": null,
                "zoomable_value": null,
                "Phases": null,
                "Wires": null,
                "Radius": null,
                "Length": "481",
                "Height": "71",
                "Width": "372",
                "Family_name": "Vega",
                "cat_name": "Floodlight",
                "family_shortcut_code": "VE",
                "supplier_name": "Wuckert PLC",
                "supplier_id": "165",
                "description": "Vega - Floodlight <b style=\"font-weight: bold;\"></b> Suspendant, Mounted on pole, Surface <b style=\"font-weight: bold;\">240 4000K</b> -  70 32842 - -IP 67 - <b style=\"font-weight: bold;\">Shanahan, Dare and Schulist LED </b><b style=\"font-weight: bold;\">Rectangular  W372 x L481 x H71</b> BLACK / Die-cast aluminum (Housing)  - <b style=\"font-weight: bold;\">5  </b><br/>",
                "photo_url": " https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/507/{image_name}.jpg ",
                "datasheet_url": null,
                "CCT_values": "4000",
                "Beam_angle": "90 - 120",
                "input_voltage": "-",
                "WorkingTemperature": "-",
                "qty_ctn": "1",
                "ctn_size_cbm": "W39.5 x L39.5 x H15",
                "ctn_volume": 0.02340375,
                "symbol": "$",
                "liminous_efficiency": "136.8lm/w",
                "dimension": "Rectangular  W372 x L481 x H71",
                "cut_out": null,
                "time_diff": "1321 days"
            }      ],
        "total_count": "2"
    }
}

Possible Error

Code	Message	Description
400	Bad Request	Invalid query parameters provided.
401	Unauthorized	Missing or invalid API key.
404	Not Found	No product found with the specified ID.
500	Internal Server Error	An unexpected error occurred on the server.

Get Product Details

This endpoint retrieves detailed information for a single product. It is useful when you need to display or integrate full product information, including its attributes,

Endpoint
    GET /product_development/v1/products/{product_id}

Path Parameters:

• Product_id (integer): The unique ID of the product.

Request Example

    curl -X GET "https://api.lumytic.com/product_development/v1/products/520
    
    -H "ApiKey: YOUR_API_KEY_HERE" \
    
    -H "Content-Type: application/json

    -H "Accept-Language: en"

Response Example

    {
    "success": true,
    "message": "collection fetched successfully.",
    "data": {
        "ID": "49431",
        "weight": null,
        "CRI": "82",
        "Multiple_ip": "0",
        "Front_ip": null,
        "Back_ip": null,
        "IP": "67",
        "IK": "8",
        "Power_up": "0",
        "Power": "10",
        "Current": null,
        "frequency": null,
        "Lumen": "912",
        "PowerFactor": null,
        "warranty": "3",
        "lifespan": "30000",
        "reference_code": null,
        "product_number": "P2-IN-AMB10-04-017916",
        "Firerated": "0",
        "Firerated_value": null,
        "labels": null,
        "product_status": "Continued",
        "barcode": null,
        "zoomable": null,
        "zoomable_value": null,
        "Phases": null,
        "Wires": null,
        "Radius": null,
        "Length": "124",
        "Height": "199",
        "Width": "95",
        "product_function": null,
        "AdjustableType": "Not Adjustable",
        "PowerType": "Dedicated driver",
        "dc_voltage": null,
        "manufacturing_technique": "CBU Completely Built Unit",
        "Cut_out": "84",
        "Family_name": "Ambi",
        "cat_name": "Inground light ",
        "productID": "273",
        "CCT_values": "3000",
        "description": "Ambi - Inground light  <b style=\"font-weight: bold;\"></b> Recessed <b style=\"font-weight: bold;\">10 3000K</b> -  82 912 - -IP 67 - <b style=\"font-weight: bold;\">Lueilwitz PLC LED </b><b style=\"font-weight: bold;\">Square  W95 x L95 x H135</b>  84 grey / Die-cast aluminum (Housing) - Grey Housing / Die-cast aluminum (Front Cover ) - transparent / Tempered glass  (Front Cover ) - BLACK / plastic (Installation sleeve)  - <b style=\"font-weight: bold;\">3  </b><br/>",
        "Beam_angle": "23",
        "input_voltage": "-",
        "WorkingTemperature": "-",
        "power": "10",
        "qty_ctn": "5",
        "ctn_size_cbm": "W16.5 x L63 x H67",
        "ctn_volume": 0.0696465,
        "symbol": "$",
        "installation_way": [
            "Recessed"      ],
        "fitting_shape": "Square",
        "voltage_type": "",
        "application": [
            "Offices",
            "Hospitals & Clinics",
            "Supermarkets",
        ],
        "category_name": "Inground light ",
        "lighting_distributor": [
            { 
                "kind": "Reflector ",
                "color": "Silver ",
                "material": "Plastic painted",
                "Texture_photo": " https:// {domain_name}.lumytic.com/tenants/{tenant_name }/includes/upload_files/Texture/{image_name}.jpg ",
            }
        ],
        "datasheet_url": null,
        "photo_url": " https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/273/{image_name}.jpg ",
        "led_code": "temp005",
        "driver_code": "temp006",
        "certifications": "",
        "solar_data": null,
        "fitting_color": [
            {
                "part": "Housing",
                "color": "grey",
                "material": "Die-cast aluminum",
                "Texture_photo": "https:// {domain_name}.lumytic.com/tenants/{tenant_name }/includes/upload_files/Texture/{image_name}.jpg"
            },
            {
                "part": "Front Cover ",
                "color": "Grey Housing",
                "material": "Die-cast aluminum",
                "Texture_photo": " https:// {domain_name}.lumytic.com/tenants/{tenant_name }/includes/upload_files/Texture/{image_name}.jpg "
            },
      
        ],
        "usd_price": 23.7,
        "accessories": []
    }
}

Possible Error

Code	Message	Description
400	Bad Request	Invalid path parameters provid
401	Unauthorized	Missing or invalid API ke
404	Not Found	No product found with the specified ID
500	Internal Server Error	An unexpected error occurred on the serve