[GET] ~/vehicles/byvin/{vin}

Returns a single vehicle.

Request Information

URI Parameters

NameDescriptionType
vin

The Vehicle Identification Number (VIN) of the vehicle.

string

This value is required and must not be omitted.

Body Parameters

None.

Request Formats

None.

Response Information

Resource Description

A task that represents the asynchronous get vehicle operation.the vehicle.

An instance of: Vehicle
NameDescriptionType
Fuel

The fuel.

IdNamePairGroup

Gearbox

The gearbox.

IdNamePairGroup

Body

The body type.

IdNamePairGroup

BodyGroup

The body group.

IdNamePairGroup

PreviousUsageType

The previous usage type.

IdNamePairGroup

FairMarketPrice

The fair market price information.

FairMarketPriceInfo

HasTestDrive

true if a test drive can be requested.

boolean

Environment

The pixelconcept environment.

string

Id

The vehicle identifier.

integer

UniqueId

The unique identifier over all pixelconcept environments.

string

JatoVehicleId

The jato vehicle id.

integer

OwnerId

The owner id.

integer

LocationOwnerId

The location owner id, is differnet from the owner is, if the vehicle has a different location.

integer

LocationOwner

The location owner name (is not used)

string

Contact

The complete contact information of the vehicle, from the location owner.

Contact

OrderNumber

The order number.

string

Kuerzel

The short owner key.

string

Manufacturer

The manufacturer.

IdNamePair

Model

The model.

IdNamePair

ModelGroup

The model group.

IdNamePair

ModelExtension

The model extension.

string

ModelLine

The model line.

IdNamePair

Variante

The variante (only for BMW and MINI available).

IdNamePair

PreviousUsageType

The previous usage type.

IdNamePair

Body

The body type.

IdNamePair

AvailableFrom

The available from date.

DateTimeItem

AvailableTo

The available to date.

DateTimeItem

VIN

The vehicle identification number (VIN).

string

AlternateVIN

The alternate vehicle identification number (VIN) e.g. Alpina.

string

HSN

The HSN (German manufacturer code).

string

TSN

The TSN (German model code).

string

KW

The power of the engine in kilowatt.

integer

HP

The power of the engine in horsepower.

integer

DriveMechanism

The drive mechanism.

string

DateOfFirstRegistration

The date of first registration.

DateTimeItem

CubicCapacity

The cubic capacity.

integer

DoorsCount

Number of doors.

integer

Mileage

The mileage in kílometer.

integer

CylinderCount

Number of cylinders.

integer

Range

The range in kilometer.

integer

ReservedUntil

The date until this vehicle is reserved for a customer.

date

KwElectrical

The power of a electric engine in kilowatt.

integer

HpElectrical

The power of a electric engine in horsepower.

integer

KwElectricalPeak

The peak power output of a electric engine in kilowatt.

integer

HpElectricalPeak

The peak power output of a electric engine in horsepower.

integer

KwElectricalPermanent

The permanent power output of a electric engine in kilowatt.

integer

HpElectricalPermanent

The permanent power output of a electric engine in horsepower.

integer

TypeKey

The type key.

string

PreviousOwnersCount

The number of previous owners.

integer

HasNewTechnicialInspection

Has a new technical inspection before delivery.

boolean

DateOfNextTechnicialInspection

The date of next technical inspection.

DateTimeItem

HasNewExhaustInspection

Has a new exhaust inspection before delivery (DEPRECATED).

boolean

DateOfNextExhaustInspection

The date of next exhaust inspection (DEPRECATED).

DateTimeItem

SeatCover

The seat cover description.

string

SeatCovering

The seat cover.

IdNamePair

SeatCoverBaseColor

The seat cover base color.

IdNamePair

SeatCoverMaterial

The seat cover material.

IdNamePair

Furnier

The veneer.

string

EquipmentFreeText

The equipment free text description.

string

EquipmentComplete

The complete equipment as one text.

string

EquipmentOptional

The optional equipment as text.

string

SeatCount

The number of seats.

integer

IsCommissionCar

true if this vehicle is a commission car.

boolean

IsAccidentFree

true if this vehicle is accident free.

boolean

IsUnrepaired

true if this vehicle is unrepaired.

boolean

IsNewSetting

true if this vehicle is newly imported.

boolean

IsRightHandDrive

true if this vehicle is right hand drive.

boolean

HasGuarantee

true if this vehicle has guarantee.

boolean

Guarantee

The guarantee.

IdNamePair

GuaranteeStartArt

The guarantee start art.

string

GuaranteeStartDate

The guarantee start date.

DateTimeItem

IsBmwAgKfz

true if this vehicle is owned by BMW AG.

boolean

AreasOfDamages

The areas of damages.

string

HistoryOfDamages

The history of damages.

string

BasePaintColor

The base paint color.

IdNamePair

PaintColor

The paint color.

string

PaintColoring

The base paint color.

IdNamePair

HasMetallicPaint

true if this vehicle has metallic paint.

boolean

HasPearlEffectPaint

true if this vehicle has pearl effect paint.

boolean

HasSpecialEffectPaint

true if this vehicle has pearl effect paint.

boolean

HasReservation

true if this vehicle has reservation.

boolean

ShowOnline

true to show, false to hide the vehicle.

boolean

ShowDealer

true to show for dealer, false to hide for dealer.

boolean

SealOfQuality

The seal of quality.

SealOfQuality

Fuel

The fuel.

IdNamePair

CarLabelFuel1

The primary fuel for the efficiency label.

string

CarLabelFuel2

The secondary fuel for the efficiency label.

string

NameOfPurchasingAgent

The name of the purchasing agent.

string

PurchaseDate

The purchase date.

DateTimeItem

NameOfLastOwner

The name of the last owner.

string

Notice

The notice.

string

Co2EfficiencyClass

The CO2 efficiency class.

IdNamePair

HasManufacturerGuaranteeSeal

true if this vehicle has manufacturer guarantee seal.

boolean

Gearbox

The gearbox.

IdNamePair

FuelConsumptionCombined

The combined fuel consumption (in liters per 100 km).

decimal number

FuelConsumptionUrban

The fuel consumption for urban driving (in liters per 100 km).

decimal number

FuelConsumptionSuburban

The fuel consumption for suburban driving (in liters per 100 km).

decimal number

CO2EmissionCombined

The combined value of CO2 emission (in grams per km).

integer

EnergyConsumptionCombined

The combined value of electric energy consumption (in kilowatt per 100 km).

integer

EnergylabelFuel

The energylabel fuel.

string

PowerConsumptionCombined

The combined value of electric energy consumption (in kilowatt per 100 km).

decimal number

EnvironmentBadge

The environment badge.

IdNamePair

EmissionNorm

The emission norm.

integer

EmissionClass

The emission class.

IdNamePair

ConsumerPrice

The consumer price.

PriceItem

ConsumerStandardPrice

The consumer standard price.

PriceItem

DealerPrice

The dealer price.

PriceItem

OldListPrice

The old list price.

PriceItem

CampaignPriceMarket

The campaign price market.

PriceItem

LastHistoryPrice

The last history price.

PriceItem

InterfacePrice

The interface price.

PriceItem

InterfacePrices

List of interface prices.

Collection of PriceItem

AdditionPrices

List of additional prices.

Collection of PriceItem

MediaItems

List of media items.

Collection of MediaItem

FinancingOptions

List of available financing options.

Collection of FinancialItem

LeasingOptions

List of available leasing options.

Collection of FinancialItem

OptionGroups

List of grouped equipments.

Collection of OptionGroupItem

Equipment

List of equipments.

Equipment

TechnicalData

List of grouped technical data.

Collection of TechDataGroup

InCampaigns

List of campaign/promotion identifiers this vehicle is associated with.

Collection of integer

SuggestedRetailPrice

The suggested retail price.

PriceItem

ProcessTypeLeasing

The leasing process type.

string

LicensePlate

The license plate.

string

PriorDamage

The prior damage.

string

Dossiers

List of attached document items.

Collection of DossierItem

IsAlphaController

true if this vehicle is an AlphaController vehicle.

boolean

Nova

The Nova classification for Austrian vehicles.

decimal number

NovaBonus

The Nova bonus or malus for Austrian vehicles.

decimal number

NOxEmissionCombined

The combined value of NOx emissions (in milligrams per kilometer).

decimal number

GuaranteeDurationMonth

The guarantee start date.

integer

DateOfManufacture

The date of manufacture.

DateTimeItem

WltpFuelConsumptionLow

The fuel consumption in WLTP test cycle Low (in liter per 100 km).

decimal number

WltpFuelConsumptionMedium

The fuel consumption in WLTP test cycle Medium (in liter per 100 km).

decimal number

WltpFuelConsumptionHigh

The fuel consumption in WLTP test cycle High (in liter per 100 km).

decimal number

WltpFuelConsumptionExtraHigh

The fuel consumption in WLTP test cycle Extra-High (in liter per 100 km).

decimal number

WltpFuelConsumptionCombined

The combined average fuel consumption of all WLTP test cycles (in liter per 100 km).

decimal number

WltpFuelConsumptionWeighted

The weighted average fuel consumption of all WLTP test cycles (in liter per 100 km).

decimal number

WltpConsumptionMixedMin

The wltp consumption mixed minimum (in liter per 100 km).

decimal number

WltpConsumptionMixedMax

The wltp consumption mixed maximum (in liter per 100 km).

decimal number

WltpConsumptionElectricalMin

The wltp consumption electrical minimum (in kilowatt per 100 km).

decimal number

WltpConsumptionElectricalMax

The wltp consumption electrical maximum (in kilowatt per 100 km).

decimal number

WltpCo2EmissionLow

The CO2 emission in WLTP test cycle Low (in grams per km).

integer

WltpCo2EmissionMedium

The CO2 emission in WLTP test cycle Medium (in grams per km).

integer

WltpCo2EmissionHigh

The CO2 emission in WLTP test cycle High (in grams per km).

integer

WltpCo2EmissionExtraHigh

The CO2 emission in WLTP test cycle Extra-High (in grams per km).

integer

WltpCo2EmissionCombined

The combined average CO2 emission of all WLTP test cycles (in grams per km).

integer

WltpCo2EmissionWeighted

The weighted average CO2 emission of all WLTP test cycles (in grams per km).

integer

WltpCo2EmissionMin

The wltp co 2 emission minimum (in grams per km).

decimal number

WltpCo2EmissionMax

The wltp co 2 emission maximum (in grams per km).

decimal number

InExportAccessorIds

List of accessor identifiers of exports the vehicle is activated for.

Collection of integer

BodyGroup

The body group.

IdNamePair

EurotaxCode

The eurotax code.

string

SubTitle

The model subtitle.

string

Baureihe

The baureihe.

IdNamePair

WltpElectricCombined

The wltp consumption electrical combined (in kilowatt per 100 km).

decimal number

WltpElectricWeighted

The wltp consumption electrical weighted (in kilowatt per 100 km).

decimal number

WltpElectricRange

The wltp electric range (in km).

decimal number

ElectricRange

The electric range (in km).

decimal number

NedcDataNotAvailable

The nedc data not available.

boolean

DeliveryPeriod

The delivery periode.

integer

SchwackeCode

The schwacke code.

string

Highlights

The highlights.

Collection of string

ConsumptionDataRequired

true if consumption information is required.

boolean

AdditionalInformations

Collection of KeyValuePair

Response Formats

application/json

Sample:

Sample not available.

text/json

Sample:

Sample not available.