---
title: "Specifications for the vehicle a VIN decodes to."
method: GET
path: "/v1/vin/{vin}/specs"
tags: ["VIN"]
---

# Specifications for the vehicle a VIN decodes to.

`GET /v1/vin/{vin}/specs`

## Request

- Base URL: `https://open.wenmarpro.com`
- URL: `https://open.wenmarpro.com/v1/vin/{vin}/specs`
- Auth: none declared

Narrowed to the decoded engine when the decode settles it, as the
fuel route is.

## Path parameters

- `vin` string, required

## Query parameters

- `year` integer

## Response `200`

The specifications.

- VinSpecs: The specifications for the vehicle a VIN decodes to.
  - `as_of` string, nullable
  - `attribution` string[], required
  - `decode` RecallDecode, required: What a VIN decoded to, as far as recalls need it.
    - `make` string, nullable
    - `model` string, nullable
    - `trim` string, nullable
    - `valid` boolean, required: Whether the check digit is right.
    - `vin` string, required
    - `year` integer, nullable
  - `engine` EngineRef: A catalog engine of the model year.
    - `id` string, required: The engine's id form, as in a vehicle id.
    - `label` string, required
    - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine.
  - `engine_settled` boolean, required: Whether `specs` is narrowed to `engine`.
  - `specs` Spec[], required
    - `battery_type` string, nullable
    - `battery_voltage` integer, nullable
    - `confidence` string, required: `model`, `engine` or `submodel`, as on a fuel rating.
    - `cylinder_deactivation` boolean, nullable
    - `cylinder_deactivation_name` string, nullable: The maker's name for it, such as `Active Fuel Management`.
    - `described_as` string, required
    - `drive` string, nullable
    - `electrification` string, nullable: EPA's kind of alternative powertrain: `Hybrid`, `Plug-in Hybrid`, `EV`, `FFV`, `Diesel`.
    - `emission_standards` SpecEmission[], required
      - `engine_family` string, required: The engine family (test group).
      - `sales_area` integer, required: EPA's sales area code, a number. EPA's column list does not say what each number means, so no name is given.
      - `smog_score` integer, nullable: EPA's smog rating, 1 (worst) to 10 (best).
      - `standard` string, required
      - `standard_text` string, nullable
    - `engine` EngineRef: A catalog engine of the model year.
      - `id` string, required: The engine's id form, as in a vehicle id.
      - `label` string, required
      - `vin8` string, nullable: The characters in position 8 of a VIN that mean this engine.
    - `ev_motor` string, nullable
    - `exhaust_valves` integer, nullable
    - `fuel_grade` string, required
    - `fuel_usage` string, nullable: Whether the grade is recommended or required, in EPA's words.
    - `gears` integer, nullable
    - `intake_valves` integer, nullable: Per cylinder.
    - `luggage_volume_ft3` integer, nullable
    - `luggage_volume_l` integer, nullable
    - `motor_kw` string, nullable: Rated motor power in kW, as EPA's file writes it: `135`, `8 and 30`.
    - `passenger_volume_ft3` integer, nullable
    - `passenger_volume_l` integer, nullable
    - `size_class` string, required
    - `source` string, required
    - `source_id` string, required
    - `start_stop` boolean, nullable
    - `supercharger` boolean, required
    - `transmission` string, nullable
    - `transmission_type` string, nullable
    - `turbo` boolean, required
    - `variable_valve_lift` boolean, nullable
    - `variable_valve_timing` boolean, nullable
  - `vehicle` RecallVehicle: The model year an answer is about.
    - `id` string, required: The id of the year, make and model.
    - `make` string, required
    - `model` string, required
    - `year` integer, required
  - `warnings` Warning[], required
    - `code` string, required: `invalid_check_digit`, `model_year_unknown`, `no_patterns` or `model_unresolved`. More may be added.
    - `message` string, required
    - `suggestions` string[]: VINs the caller may have meant.

## Other responses

- `400`: `invalid_vin`, or `validation_failed` for `year`.
- `404`: `not_found`: no manufacturer is registered for the first three characters. `dataset_unavailable`: this server holds no specifications.

---

[API](https://skmtc.dev/wenmarpro/apis/wenmar-open.md) · [All operations](https://skmtc.dev/wenmarpro/apis/wenmar-open/llms.txt) · [OpenAPI document](https://skmtc.dev/wenmarpro/apis/wenmar-open/revisions/1027b548b6f0?raw)