Categories

This service provides category and part type data

Service Endpoint

POST https://api.groupvan.com/v2_1/catalog/categories

Try it

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"
                    ]
                }
            ]
        }
    ]
}