Categories#

This service provides category and part type data

Service Endpoint#
POST https://api.groupvan.com/v2_1/catalog/categories

Application Categories#

Requests for application categories and part types require information from the Vehicles and Top Categories services.

Parameters#

base_vehicle_id integer required

Base Vehicle ID returned from Vehicles service, engine configuration object

engine_key_id string

Engine Key ID returned from Vehicles service, engine configuration object if fully qualified engine is selected

top_category_id integer required

Top Category ID selected from the Top Categories service

taxonomy string required

Taxonomy of the top category selected

respponse_items array required

Array of strings “top_category” and/or “category”

Examples#

Example Request w/ engine selected#
{
    "base_vehicle_id": 18664,
    "engine_key_id": "18664_905_7492",
    "top_category_id": 300000000,
    "taxonomy": "app"
}
Example Request w/o engine selected#
{
    "base_vehicle_id": 18664,
    "top_category_id": 300000000,
    "taxonomy": "app"
}

Non-Application Categories#

Requests for non-application categories and products require information from the Top Categories service.

Parameters#

top_category_id integer required

Top Category ID selected from the Top Categories service

taxonomy string required

Taxonomy of the top category selected

Examples#

Example Request#
{
    "top_category_id": 57,
    "taxonomy": "non"
}

Response#

Response JSON
{
    "categories": [
        {
            "display_tier": "primary",
            "id": 32,
            "name": "A/C Compressor Replacement",
            "part_types": [
                {
                    "display_tier": "primary",
                    "id": 10459,
                    "name": "A/C Accumulator",
                    "popularity_group": 1,
                    "slang_list": [
                        "a/c",
                        "accum",
                        "accumulator",
                        "acum",
                        "acumulator",
                        "air conditioning",
                        "air conditionning",
                        "climate",
                        "compresor",
                        "compressor",
                        "condenser",
                        "drier",
                        "dryer",
                        "receiver drier",
                        "temperature"
                    ]
                },
                {
                    "display_tier": "primary",
                    "id": 6628,
                    "name": "A/C Compressor",
                    "popularity_group": 313290,
                    "slang_list": [
                        "a/c",
                        "ac compressor",
                        "accum",
                        "accumulator",
                        "acum",
                        "acumulator",
                        "air conditioning",
                        "air conditionning",
                        "climate",
                        "compresor",
                        "compressor",
                        "condenser",
                        "drier",
                        "dryer",
                        "new compressor",
                        "temperature"
                    ]
                }
            ]
        },
        {
            "display_tier": "primary",
            "id": 33,
            "name": "A/C Condenser Replacement",
            "part_types": [
                {
                    "display_tier": "primary",
                    "id": 10459,
                    "name": "A/C Accumulator",
                    "popularity_group": 0,
                    "slang_list": [
                        "a/c",
                        "accum",
                        "accumulator",
                        "acum",
                        "acumulator",
                        "air conditioning",
                        "air conditionning",
                        "climate",
                        "compresor",
                        "compressor",
                        "condenser",
                        "drier",
                        "dryer",
                        "receiver drier",
                        "temperature"
                    ]
                },
                {
                    "display_tier": "primary",
                    "id": 6768,
                    "name": "A/C Evaporator Core",
                    "popularity_group": 0,
                    "slang_list": [
                        "a/c",
                        "air conditioning",
                        "air conditionning",
                        "climate",
                        "control",
                        "evap",
                        "evaporator",
                        "temperature"
                    ]
                }
            ]
        }
    ]
}