CONTENTS

×
Download PDF

REST API DOCUMENTATION

Download PDF

In order to start using the API you will need your Unique Key provided by AutoSaver. If you have any questions, please contact us at support@mytradevue.com

Get Vehicle Makes

Returns a list of vehicle makes for a specific year in JSON format. Items are ordered by name.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetMakes
URI Template

URI Template

GetMakes?year={year}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetMakes?year=2014&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":3,"Name":"Acura"},{"ID":5,"Name":"Aston Martin"},{"ID":6,"Name":"Audi"},{"ID":8,"Name":"Bentley"},{"ID":7,"Name":"BMW"},{"ID":10,"Name":"Buick"},{"ID":11,"Name":"Cadillac"},{"ID":12,"Name":"Chevrolet"},{"ID":13,"Name":"Chrysler"},{"ID":15,"Name":"Dodge"},{"ID":18,"Name":"Ferrari"},{"ID":17,"Name":"FIAT"},{"ID":20,"Name":"Ford"},{"ID":21,"Name":"GMC"},{"ID":24,"Name":"Honda"},{"ID":25,"Name":"Hyundai"},{"ID":26,"Name":"Infiniti"},{"ID":28,"Name":"Jaguar"},{"ID":29,"Name":"Jeep"},{"ID":30,"Name":"Kia"},{"ID":31,"Name":"Lamborghini"},{"ID":32,"Name":"Land Rover"},{"ID":33,"Name":"Lexus"},{"ID":34,"Name":"Lincoln"},{"ID":35,"Name":"Lotus"},{"ID":37,"Name":"Maserati"},{"ID":39,"Name":"Mazda"},{"ID":41,"Name":"Mercedes-Benz"},{"ID":36,"Name":"MINI"},{"ID":43,"Name":"Mitsubishi"},{"ID":44,"Name":"Nissan"},{"ID":49,"Name":"Porsche"},{"ID":50,"Name":"Ram"},{"ID":51,"Name":"Rolls-Royce"},{"ID":54,"Name":"Scion"},{"ID":62,"Name":"smart"},{"ID":56,"Name":"Subaru"},{"ID":58,"Name":"Tesla"},{"ID":59,"Name":"Toyota"},{"ID":60,"Name":"Volkswagen"},{"ID":61,"Name":"Volvo"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get Vehicle Models

Returns a list of vehicle models for a specific year and make in JSON format. Items are ordered by name. It depends on MakeID parameter retrieved from the GetMakes REST Method as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetModels
URI Template

URI Template

GetModels?year={year}&makeID={makeID}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetModels?year=2014&makeID=3&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
MakeID Integer 3
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":3,"Name":"ILX"},{"ID":4,"Name":"ILX Hybrid"},{"ID":7,"Name":"MDX"},{"ID":9,"Name":"RDX"},{"ID":11,"Name":"RLX"},{"ID":14,"Name":"TL"},{"ID":16,"Name":"TSX"},{"ID":17,"Name":"TSX Sport Wagon"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get Trim Styles

Returns a list of vehicle trim styles for a specific YMM in JSON format. Items are ordered by name. It depends on ModelID parameter retrieved from the GetModels REST Method as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetTrimStyles
URI Template

URI Template

GetTrimStyles?year={year}&modelID={modelID}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetTrimStyles?year=2014&modelID=7&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
ModelID Integer 7
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":1615,"Name":"Advance and Entertainment Packages"},{"ID":976,"Name":"Base"},{"ID":2494,"Name":"SH-AWD"},{"ID":659,"Name":"SH-AWD w\/Advance and Entertainment Packages"},{"ID":2537,"Name":"SH-AWD w\/Technology and Entertainment Packages"},{"ID":954,"Name":"SH-AWD w\/Technology Package"},{"ID":352,"Name":"Technology and Entertainment Packages"},{"ID":2553,"Name":"Technology Package"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get Body Styles

Returns a list of vehicle body styles for a specific YMMT in JSON format. Items are ordered by name. It depends on ModelID and TrimID parameters retrieved from the respective GetModels and GetTrimStyles REST Methods as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetBodyStyles
URI Template

URI Template

GetBodyStyles?year={year}&modelID={modelID}&trimID={trimID}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetBodyStyles?year=2014&modelID=7&trimID=1615&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
ModelID Integer 7
TrimID Integer 1615
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":1,"Name":"SUV"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get Engines

Returns a list of engines available for a specific body style of YMMT in JSON format. Items are ordered by name. It depends on ModelID, TrimID and BodyID parameters retrieved from the respective GetModels, GetTrimStyles and GetBodyStyles REST Methods as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetEngines
URI Template

URI Template

GetEngines?year={year}&modelID={modelID}&trimID={trimID}&bodyID={bodyID}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetEngines?year=2014&modelID=7&trimID=1615&bodyID=1&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
ModelID Integer 7
TrimID Integer 1615
BodyID Integer 1
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":31,"Name":"3.50L 6cyl"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get Transmissions

Returns a list of transmissions available for a specific vehicle defined in terms of YMMT, body style and engine in JSON format. Items are ordered by name. It depends on ModelID, TrimID, BodyID and EngineID parameters retrieved from the respective GetModels, GetTrimStyles, GetBodyStyles and GetEngines REST Methods as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetTransmissions
URI Template

URI Template

GetTransmissions?year={year}&modelID={modelID}&trimID={trimID}&bodyID={bodyID}&engineID={engineID}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetTransmissions?year=2014&modelID=7&trimID=1615&bodyID=1&engineID=31&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
ModelID Integer 7
TrimID Integer 1615
BodyID Integer 1
EngineID Integer 31
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":9,"Name":"6 speed Shiftable automatic"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get DriveTrains

Returns a list of drive types available for a specific vehicle defined in terms of YMMT, body style, engine and transmission in JSON format. Items are ordered by name. It depends on ModelID, TrimID, BodyID, EngineID and TransmissionID parameters retrieved from the respective GetModels, GetTrimStyles, GetBodyStyles, GetEngines and GetTransmissions REST Methods as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetDrivetrains
URI Template

URI Template

GetDrivetrains?year={year}&modelID={modelID}&trimID={trimID}&bodyID={bodyID}&engineID={engineID}&transmissionID={transmissionID}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetDrivetrains?year=2014&modelID=7&trimID=1615&bodyID=1&engineID=31&transmissionID=9&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2014
ModelID Integer 7
TrimID Integer 1615
BodyID Integer 1
EngineID Integer 31
TransmissionID Integer 9
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "ID" : {integer},
    "Name" : {string}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"ID":1,"Name":"FWD (front wheel drive)"}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Get Vehicle Appraisal Value

Returns a series of values for each level of the VRM diamond, including average market price, for a specific vehicle defined in terms of YMMT, body style, engine, transmission and drive type in JSON format. It depends on ModelID, TrimID, BodyID, EngineID, TransmissionID and DrivetrainID parameters retrieved from the respective GetModels, GetTrimStyles, GetBodyStyles, GetEngines, GetTransmissions and GetDrivetrains REST Methods as ID.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

GetDealerTradeIn
URI Template

URI Template

GetDealerTradeIn?year={year}&modelID={modelID}&trimID={trimID}&bodyID={bodyID}&engineID={engineID}&transmissionID={transmissionID}&drivetrainID={drivetrainID}&mileage={mileage}&zipCode={zipCode}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/GetDealerTradeIn?year=2010&modelID=7&trimID=1615&bodyID=1&engineID=30&transmissionID=9&drivetrainID=2&mileage=43222&zipCode=30341&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
Year Integer 2010
ModelID Integer 7
TrimID Integer 1615
BodyID Integer 1
EngineID Integer 30
TransmissionID Integer 9
DrivetrainID Integer 2
Mileage Integer 43222
ZipCode String 30341
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "LevelOne" : {decimal},
    "LevelTwo" : {decimal},
    "LevelThree" : {decimal},
    "LevelFour" : {decimal},
    "LevelFive" : {decimal},
    "LevelSix" : {decimal},
    "LevelSeven" : {decimal},
    "PriceRangeLow" : {decimal},
    "PriceRangeHigh" : {decimal},
    "RoughTrade" : {decimal},
    "AverageTrade" : {decimal},
    "CleanTrade" : {decimal}
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

{"LevelOne":11584,"LevelTwo":11345,"LevelThree":11105,
"LevelFour":10865,"LevelFive":10625,"LevelSix":10385,
"LevelSeven":10145,"PriceRangeLow":9905,"PriceRangeHigh":11584,
"RoughTrade":9905,"AverageTrade":10865,"CleanTrade":11584}
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}
Note

Note

LevelOne to LevelSeven from the JSON result will go from the top to the bottom of the VRM diamond respectively.
AverageTrade from the JSON result represents the vehicle appraisal value.

Decode VIN

This method is used for decoding VIN and returns full vehicle details. It's a standalone feature and does not depend on any of TradeVue REST API methods above.

For some VINs the decoder returns several vehicles which differ by Trim, Engine or Transmission. Because it is not always possible to decode these parameters, the decoder returns all possible variations of a vehicle for a given VIN.

Base URL

Base URL

https://api.autosaver.com/TradeVue.svc/
REST Method Name

REST Method Name

DecodeVin
URI Template

URI Template

DecodeVin?vin={vin}&key={key}
Sample Call

Sample Call

https://api.autosaver.com/TradeVue.svc/DecodeVin?vin=1B3EL46X34N240453&key=YOUR_KEY
Method

Method

GET
Format

Format

JSON
Url Params
Parameter Name Data Type Sample Value
VIN String 1B3EL46X34N240453
Key String 398996FF-8F92-4247-9175-B52D1A0964F3
JSON Response Data Object

JSON Response Data Object

{
    "VehicleName" : {string},
    "Year" : {integer},
    "Make" : {string},
    "Model" : {string},
    "Trim" : {string},
    "Body" : {string},
    "EngineSize" : {nullable decimal},
    "EngineType" : {string},
    "EngineCylinder" : {nullable integer},
    "Transmission" : {string},
    "TransmissionType" : {string},
    "AutomaticType" : {string},
    "NumberOfSpeeds" : {string},
    "VehicleType" : {string},
    "FuelType" : {string},
    "DrivenWheels" : {string},
    "Doors" : {nullable integer},
    "BaseMSRP" : {nullable integer},
    "MpgCity" : {nullable integer},
    "MpgHighway" : {nullable integer},
    "MakeID" : {integer},
    "ModelID" : {integer},
    "TransmissionID" : {integer},
    "BodyID" : {integer},
    "EngineID" : {integer},
    "TrimID" : {integer},
}
Success Response

Success Response

Example:
Status Code: 200
JSON Response:

[{"VehicleName":"SXT 4dr Sedan (2.4L 4cyl 4A)","Year":2004,
"Make":"Dodge","Model":"Stratus","Trim":"SXT","Body":"Sedan"
,"EngineSize":2.40,"EngineType":"gas","EngineCylinder":4,
"Transmission":"4A","TransmissionType":"AUTOMATIC",
"AutomaticType":null,"NumberOfSpeeds":"4","VehicleType":"Car",
"FuelType":"regular unleaded","DrivenWheels":"front wheel drive","Doors":4,"BaseMSRP":19970,
"MpgCity":20,"MpgHighway":27,"MakeID":15,"ModelID":312,
"TransmissionID":1,"BodyID":3,"EngineID":683,"TrimID":2601}]
Error Response

Error Response

Example:
Status Code: 401
JSON Response:
{"Message":"Unauthorized", "StatusCode":401}

Contact Us