Vehicle Search

Use number search to get all available vehicles in the market for shortId, modelId or kType. It is possible to combine those numbers, but the results will be include only the results which are in both numbers. The request needs to include one number at least.

Query URL

https://onedb.tecalliance.cn/api/vehicles/chinaid

Query parameter

Name Type Required Example Description
shortId String No, if one of the other numbers are added MM05003016D0005 This is the shortId of a vehicle.
modelId String No, if one of the other numbers are added MM05003016D This is the modelId of a vehicle.
ktype Integer No, if one of the other numbers are added 108611 This is the TecDoc kType number of vehicle.
perpage Integer No 50 The number of vehicles in the response body per request.
page Integer No 1 The page to visit if the total number is larger than the number of vehicles per page.

JSON Input

{
  "shortId": "MM05003016D0005"
}
              

RESPONSE

A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.

Name Type Example Description
totalMatching Integer 16 The total number of matching vehicles for the submitted request.
MaxAllowedPage Integer 2 The max number of page the user can visit when requested vehicles for a specific page.
shortId String MM05003016D0005 the standard model library unique ID (consisting of "modelId" & "serial number");
modelId String MM05003016D model ID (by "brand & manufacturer & car & car" & "displacement" & "transmission abbreviation");
Example: MM05003016D decomposition: MM05003 only represents "brand MINI" "manufacturer MINI" "carriage Countryman" "model Cooper Countryman All 4"; 16 stands for: "displacement 1.6"; D stands for "transmission referred to as hand-integrated"
chinaIdStatus String 2019.2.22新添 shortId status (indicating whether the vehicle model information has been deleted or newly added);
oversea String 海外车 yes/no overseas car (used to distinguish whether it is a parallel imported model);
ktype Integer 108611 ktype_id (corresponding ktype model library ID);
brand String MINI brand (is the name given by the manufacturer to a class of vehicles, for example: MINI);
manufacturer String MINI manufacturer (factory attached to VIN factory);
model String Countryman car series (model series: refers to the name used by the manufacturer to indicate small categories such as price, size or weight mark);
modelType String Cooper Countryman All 4 model (model model: refers to the name given by the manufacturer to vehicles of the same type, brand, type, series and body type);
salesName String 1.6T 手自一体 Excitement sales version (mainly used to describe the vehicle configuration level);
modelDesign String R60 chassis number (model development code: means that the manufacturer distinguishes the old and new models from the same model);
modelYear Integer 2014 model (model year: which year is the annual model);
vehicleType String SUV Vehicle type (refers to the general shape characteristics, including design and purpose to distinguish vehicle types, such as: cars, sports cars, buses, trucks...);
vehicleLevel String Level (body level: the body level is distinguished according to the size, quality and speed of the vehicle shape, for example: mini car, small car, medium car, large car...);
listingYear Integer 2014 the year of listing (the official version of this model is officially announced to enter the market);
discountinuationYear Integer 2016 the year of discontinuation (the official version of this model is officially declared to stop production);
engineCode String N18B16A Engine model (refers to the characteristics of the power unit, such as the fuel used, the number of cylinders, the displacement and the static braking power, etc. The total weight of the dome mounted on a passenger car or multi-purpose passenger car or vehicle is 10000 lb or less. The engine on the 10000 lb truck should be marked with the professional manufacturer and model);
capacityLitre String 1.6 T displacement (refers to the characteristics of the power plant, such as the fuel used, the number of cylinders, displacement and static braking power, etc.);
charging String 涡轮增压 the form of intake (refers to the form of the fuel engine entering the engine when it is working, common: natural inhalation, turbocharging, supercharging, double boosting...);
maximumOutputPs Integer 122 maximum horsepower (refers to the characteristics of the power unit, such as the fuel used, the number of cylinders, displacement and static braking power, etc.);
maximumOutputKw Integer 90 maximum power (refers to the characteristics of the power unit, such as the fuel used, the number of cylinders, displacement and static braking power, etc.);
cylinderCount Integer 4 number of cylinders (refers to the characteristics of the power unit, such as the fuel used, the number of cylinders, displacement and static braking power, etc.);
valveCountPerCylinder Integer 4 the number of valves per cylinder (the number of valves per cylinder of the engine, the valves refer to: intake and exhaust valves);
fuelType String 汽油 type of fuel (refers to the characteristics of the power unit, such as the fuel used, the number of cylinders, displacement and static braking power, etc.);
mixturePreperation String 直喷 the way of supplying oil (refers to the way in which the engine work needs to burn the mixed gas to do work, and the fuel is mixed with the air entering the engine, for example: direct injection, mixing, multi-point, single point...);
transmissionType String 自动 gearbox type (automatic/manual);
transmissionDescription String 手自一体变速器(AMT) Transmission description (refers to an important device on the vehicle transmission system, to achieve the transition between starting, low speed, high speed driving, such as: manual transmission, automatic transmission, manual transmission, dual clutch transmission... );
driveSystem String 四轮驱动 drive mode (refers to the number of drive wheels, the form of the position, for example: front wheel drive);
frontBrakeType String 盘式 type of front brake (refers to the type of brake on the front wheel, for example: disc type, drum type...);
rearBrakeType String 盘式 type of rear brake (refers to the type of brake of the rear wheel, for example: disc type, drum type...);
boxDesign String 两厢 body type (according to the general structure or shape of the vehicle, there are several separate spaces in the car, such as single compartment, hatchback, and sedan);
doorCount Integer 5 number of doors;
seatCount Integer 5 number of seats;
frontTyreSpecification String 205/55 R17 front tire specifications (international standard tire code, the percentage of the section width and flatness ratio in millimeters and the diameter of the rim, eg 205/55 R17);
rearTyreSpecification String 205/55 R17 rear tire specifications (international standard tire code, in millimeters to indicate the percentage of section width and flatness ratio and rim diameter, eg: 205/55 R17);
spareTyreStandard String 非全尺寸 spare tire specification (refers to the difference between the spare tire and the original tire, for example: full size, non-full size...);

JSON Output

{
  "totalMatching": 1,
  "maxAllowedPage": 1,
  "vehicles": [
      {
          "shortId": "MM05003016D0005",
          "modelId": "MM05003016D",
          "chinaIdStatus": "",
          "oversea": "",
          "ktype": 108611,
          "tecId": "TEC000677",
          "brand": "MINI",
          "manufacturer": "MINI",
          "model": "Countryman",
          "modelType": "Cooper Countryman All 4",
          "salesName": "1.6T 手自一体 Excitement",
          "modelDesign": "R60",
          "modelYear": 2014,
          "vehicleType": "SUV",
          "vehicleLevel": "",
          "listingYear": 2014,
          "discountinuationYear": 2016,
          "engineCode": "N18B16A",
          "capacityLitre": "1.6 T",
          "charging": "涡轮增压",
          "maximumOutputPs": "122",
          "maximumOutputKw": "90",
          "cylinderCount": 4,
          "valveCountPerCylinder": 4,
          "fuelType": "汽油",
          "mixturePreperation": "直喷",
          "transmissionType": "自动",
          "transmissionDescription": "手自一体变速器(AMT)",
          "driveSystem": "四轮驱动",
          "frontBrakeType": "盘式",
          "rearBrakeType": "盘式",
          "boxDesign": "两厢",
          "doorCount": 5,
          "seatCount": "5",
          "frontTyreSpecification": "205/55 R17",
          "rearTyreSpecification": "205/55 R17",
          "spareTyreStandard": "",
          "source": "import"
      }
  ],
  "manufacturerFacet": {
      "total": 0,
      "data": null
  },
  "modelFacet": {
      "total": 0,
      "data": null
  },
  "yearFacet": null,
  "salesNameFacet": {
      "total": 0,
      "data": null
  }
}