Api documentation

Api documentation

Spec: Equipment

Spec: Equipment
 
 
v3 v2
 
 

The vehicle equipment is everything that exists within a car, including the options, engine, transmission, colors, seat configuration, brake system, air conditioning, and more.

Please note that this results for vehicles that are 2000 or older will be available in mid September, 2013.

Endpoints

Equipment Response Formats

This resource returns a list of equipment that comes either standard or optional with a car. The response describes the equipment in four different ways:

1) Typical equipment description:

  1. {
  2. "id": {integer},
  3. "name": {string},
  4. "equipmentType": {string},
  5. "availability": {string},
  6. "attributes": [{
  7. "name": {string},
  8. "value": {string}
  9. }]
  10. }

2) Engine description:

  1. {
  2. "id": {string},
  3. "name": {string},
  4. "equipmentType": "ENGINE",
  5. "availability": {string},
  6. "compressionRatio": {float},
  7. "cylinder": {integer},
  8. "size": {float},
  9. "displacement": {integer},
  10. "configuration": {string},
  11. "fuelType": {string},
  12. "horsepower": {integer},
  13. "torque": {integer},
  14. "totalValves": {integer},
  15. "manufacturerEngineCode": {string},
  16. "type": {string},
  17. "code": {string},
  18. "compressorType": {string}
  19. }

3) Transmission description:

  1. {
  2. "id": {integer},
  3. "name": {string},
  4. "equipmentType": "TRANSMISSION",
  5. "availability": {string},
  6. "automaticType": {string},
  7. "transmissionType": {string},
  8. "numberOfSpeeds": {integer}
  9. }

4) Color description

  1. {
  2. "id": {string},
  3. "name": {string},
  4. "equipmentType": "COLOR",
  5. "manufactureOptionName": {string},
  6. "manufactureOptionCode": {string},
  7. "category": {string},
  8. "colorChips": {
  9. "primary": {
  10. "r": {integer},
  11. "g": {integer},
  12. "b": {integer},
  13. "hex": {string}
  14. },
  15. "secondary": {
  16. "r": {integer},
  17. "g": {integer},
  18. "b": {integer},
  19. "hex": {string}
  20. }
  21. }
  22. }

When you parse an equipment object, make sure you look for the equipmentType value first to see how to process it. If it’s anything other than COLOR, ENGINE or TRANSMISSION, then treat it as a typical equipment.

Static Datasets

The response objects will include keys like equipmentType and availability. To understand those better, here’s a list of all possible values for both properties:

equipmentType

  • AUDIO_SYSTEM
  • COLOR
  • ENGINE
  • MANUFACTURER
  • MIRRORS
  • OPTION
  • OTHER
  • TELEMATICS
  • TIRES

availability

  • Standard
  • Optional

Equipment Names

  • 1ST_ROW_SEATS
  • 2ND_ROW_SEATS
  • 3RD_ROW_SEATS
  • 4TH_ROW_SEATS
  • 5TH_ROW_SEATS
  • AIR_CONDITIONING
  • AIRBAGS
  • AUDIO_SYSTEM
  • BRAKE_SYSTEM
  • CARGO_DIMENSIONS
  • COLLISION_SAFETY_SYSTEM
  • COLOR
  • CONVERTIBLE_ROOF
  • DIFFERENTIAL
  • DOORS
  • DRIVE_TYPE
  • DRIVER_SEAT
  • ENGINE
  • EXTERIOR_DIMENSIONS
  • EXTERIOR_LIGHTS
  • FRONT_PASSENGER_SEAT
  • INSTRUMENTATION
  • INTERIOR_DIMENSIONS
  • MANUFACTURER
  • MIRRORS
  • MOBILE_CONNECTIVITY
  • NAVIGATION_SYSTEM
  • PARKING_AID
  • POWER_OUTLETS
  • SEATBELTS
  • SEATING_CONFIGURATION
  • SECURITY
  • SPARE_TIRE/WHEEL
  • SPECIFICATIONS // for MPG and fuel capacity information
  • STEERING
  • STEERING_WHEEL
  • STORAGE
  • SUNROOF
  • SUSPENSION
  • TECHNOLOGY_FEATURE
  • TELEMATICS
  • TIRES
  • TRAILER_TOWING_EQUIPMENT
  • TRANSMISSION
  • TRUCK_BED
  • TRUNK
  • VIDEO_SYSTEM
  • WARRANTY
  • WHEELS
  • WINDOWS