Vehicle Trim

Resource for accessing information about the trims available for a vehicle model. A trim refers to a specific version or configuration of a vehicle model, distinguished by variations in features, specifications, and pricing. Each trim level offers different options such as engine types, interior and exterior designs, technology features, and optional packages. Customers choose a trim based on their preferences and requirements, allowing for customization and flexibility in vehicle selection. In the context of this API, the trim holds significant importance as it is a necessary requirement for generating quotes and issuing policies.

Properties

The fetched data provides the following properties for each entity in the collection. These properties are not meant to be submitted, unless they are specified as required or optional properties.

Name
id
Type
int
Description
Unique identifier for the model.
Name
make_id
Type
int
Description
Unique identifier for the make of the model.
Name
name
Type
string
Description
The official model's name.
Name
market_name
Type
string
Description
This could be a more localized or regionalized name for the same vehicle model. It might take into account variations in naming conventions or market preferences across different regions. For example, a vehicle might have a slightly different name in Europe compared to the United States, even though it's essentially the same model.

GET/v1/vehicle/valuation/trims/{year}/{make_id}

Get trims by model and year

This endpoint retrieves a collection of vehicle trims for a specific vehicle model and year.

Required properties

Name
model_id
Type
int
Description
The vehicle model ID for which you want to retrieve the trims.
Name
year
Type
int
Description
The vehicle year for which you want to retrieve the trims.

Request

GET

/v1/vehicle/valuation/trims/{model_id}/{year}

curl -G https://covertier.com/api/v1/vehicle/valuation/trims/{model_id}/{year} \
     -H "Authorization: Bearer {TOKEN}"

Response

{
    "data": [
        {
            "id": 7,
            "name": "A3",
            "market_name": "A3",
            "make_id": 4,
            "make_name": "Audi"
        },
        {
            "id": 4,
            "name": "A4",
            "market_name": "A4",
            "make_id": 4,
            "make_name": "Audi"
        },
        ...
    ]
}

GET/v1/vehicle/valuation/trim-by-vin/{VIN}

Get trim by VIN

This endpoint retrieves a collection of vehicle trim for a specific VIN. This method is useful when you have the VIN of a vehicle and don't need to manually determine the trim. Please notice that this request returns a single object, not an array.

Required properties

Name
vin
Type
string
Description
The vehicle VIN for which you want to retrieve the trim.

Request

GET

vehicle/valuation/trim-by-vin/{VIN}

curl -G https://covertier.com/api/v1/vehicle/valuation/trim-by-vin/{VIN} \
     -H "Authorization: Bearer {TOKEN}"

Response

{
    "data": {
        "id": 543421,
        "make_id": 7,
        "model_id": 12,
        "year": 2015
    }
}