1. Encentiv Support Center
  2. Encentiv Product Documentation

Encentiv API v3

Fetch product information based on technology, manufacturer, category, subcategory and more.

Products

1. Fetch available technology

Base URL: GET /api/v3/products/technology.json

Returns:

[
    'LED',
    ...
]

2. Fetch available manufacturers

Base URL: GET /api/v3/products/manufacturers.json

Returns:

[
    {
        "name": Manufacturer Name,
        "abbr": Manufacturer Abbr
    },
    ...
]

3. Fetch available product categories

Base URL: GET /api/v3/products/product_categories.json

URL Parameters:

Name

Description

technology

Technology

Example:

GET /api/v3/products/product_categories.json?technology=LED

Returns:

[
    {
        "abbr":         Category Abbr,
        "name":         Category Name,
        "prehours":     Default Operation Hours,
        "prewatts":     Default Existing Wattage,
        "technology":   "LED"
    },
    ...
]

4. Fetch available subcategories

Base URL: GET /api/v3/products/subcategories.json

URL Parameters:

Name Description
product_category Product Category Abbr

Example:

GET /api/v3/products/subcategories.json?product_category=LRL4

Returns:

[
    [
        Subcategory Name,
        Subcategory Abbr,
    ]
    ...
]

5. Fetch available product codes

Base URL: GET /api/v3/products/product_code.json

URL Parameters:

Name Description
manufacturer Manufacturer Abbr
product_category Product Category Abbr
subcategory Subcategory Abbr

Example:

GET /api/v3/products/product_code.json?manufacturer=GE&product_category=LRL4&subcategory=C

Returns:

[
    {
        "primarymodelnum":  Model #,
        "energyusedwatts":  Watts,
        "brightness":       Lumens,
        "lightappearance":  CCT,
        "cri":              CRI
    },
    ...
]

6. Build final skustr based on product information

Base URL: GET /api/v3/products/skustr.json

URL Parameters:

Name Description
manufacturer Manufacturer Abbr
category (it's not product_category here) Product Category Abbr
subcategory Subcategory Abbr
product_code Product Code

Example:

GET /api/v3/products/skustr.json?manufacturer=GE&category=LRL4&subcategory=C&product_code=LED12T8%2FG%2F4%2F835

Returns:

Final Product Skustr As A String