API Documentation
AutoAcquire AI Integration
API Documentation v.1.0 – 27 Aug 2025
API Revision History
Initial Version
v.1.0
27 Aug 2025
Contents
★ V2/iOffer/Appraisal/VinDecode 2
★ V2/iOffer/Appraisal/GetPrice 2
★ AUTHENTICATION - Appraisal/Auth 3
Appraisal/VinDecode Request Object Details 4
Appraisal/VINDecode Response Object Details 5
Appraisal/GetPrice Request Object Details 6
Appraisal/GetPrice Response Object Details 8
Environments
When you are ready to promote to Staging or Production, please email Scott@AutoAcquireAI.com to get your account configured.
## Endpoints:
-
V2/iOffer/AUTH
-
Get Authorization for API access
-
Environments
-
-
V2/iOffer/Appraisal/VinDecode
-
Returns the Vehicle ExactID for GetPrice Offer call
-
Environments
-
-
V2/iOffer/Appraisal/GetPrice
-
Get iOffer Pricing for Vehicle
-
Environments
-
-
AUTHENTICATION - Appraisal/Auth
POST Request
-
{
"UserName": "yourid@aaai.com",
"Password": "YourPassword"
}
Sample Response:
{
"AccessToken": "5F54ED7A-08B9-448D-A1A2-FA9EC54C3768",
"DealersId": #####
}
Response Errors
403 Sorry, wrong dealer
-
GET Appraisal/VinDecode
POST Request
{
"Vin" : "1G6AD5SS1J0153740",
"DealersId": 40475
}
Appraisal/VinDecode Request Object Details
VIN (String): The 17 Character Valid Vehicle Identification Number
DealersID (Integer); Your Dealership ID Number - 40475 (modives)
Sample Response:
{
"ExactTrims": [
{
"ExactId": 531199,
"Year": 2018,
"MakeName": "Cadillac",
"ModelName": "ATS",
"TrimName": "Premium Performance 4Dr Sedan ",
"Engine": "3.6L 6C Gas",
"EngineSizeLitters": "3.6",
"DriveTrain": "RWD",
"TransmissionWidget": "Automatic",
"DoorsWidget": "4Dr",
"BodyStyle": "Sedan",
"VehicleDescription": "2018 Cadillac ATS Premium Performance 4Dr Sedan Automatic RWD 3.6L 6C Gas",
"RecordCount": 1
}
]
}
Appraisal/VINDecode Response Object Details
“ExactId"(Integer): Vehicle ExactID - needed for GetPrice API Call
"Year"(Integer): Vehicle Year
"MakeName"(String): Vehicle Make
"ModelName"(String): Vehicle Model
"TrimName"(String): Vehicle Trim
"Engine"(String): Vehicle Engine
"EngineSizeLitters"(String): Engine Displacement in Liters
"DriveTrain"(String): DriveTrain
"TransmissionWidget"(String): Transmission
"DoorsWidget"(String): Number of Doors
“BodyStyle"(String): Vehicle Bodystyle
"VehicleDescription"(String): Complete vehicle description (yr,mk,md,trim,et. al.)
"RecordCount"(Integer): Number of Trims returned -NOTE: multiple Records may be returned
Response Errors
403 Vin not provided
403 DealersId not provided
500 Unable to Decode VIN
500 Vehicle is Older than 2000
-
Get Appraisal/GetPrice
POST Request
{
"Vin": "1G6AD5SS1J0153740",
"DealersId": 40345,
"Mileage": 12500,
"ExactId": 531199,
"OfferType": "01",
"FirstName": "Franco",
"LastName": "Pumarino",
"Phone": "5555555555",
"Email": "franco@ioffer.io",
"ZipCode": "91505"
}
Appraisal/GetPrice Request Object Details
"Vin"(String): 17 Character Vehicle Identification Number
"DealersId"(Integer): DealersID
"Mileage"(Integer): Vehicle Miles
"ExactId"(Integer): Vehicle ExactId
"OfferType"(Integer): Source (09 for Sales)
"FirstName"(String): Prospect First Name
"LastName"(String): Prospect Last Name
"Phone"(String): Prospect Phone Number
"Email"(String): Prospect Email Address
"ZipCode"(String): Prospect Zip Code
Sample Response:
{
"Appraisals": {
"Id": 603323,
"CreatedOn": "06-09-2025 12:51:06 AM",
"Vin": "1G6AD5SS1J0153740",
"VehicleSpecYear": 2018,
"VehicleSpecMake": "Cadillac",
"VehicleSpecModel": "ATS",
"VehicleSpecTrim": "Premium Performance 4Dr Sedan ",
"VehicleSpecMiles": 12500,
"VehicleSpecEngineSize": "3.6",
"VehicleSpecEngineCylinders": "6C",
"VehicleSpecEngineFuel": "Gas",
"VehicleSpecDrivetrain": "RWD",
"VehicleSpecTransmission": "Automatic",
"VehicleSpecBodyStyle": "",
"VehicleSpecBodyStyleCab": "",
"VehicleSpecSegment": "Domestic Highline Cars",
"MyPrice": 31062.552
}
}
Appraisal/GetPrice Response Object Details
"Appraisals": {
"Id"(Integer): Appraisal ID
"CreatedOn"(String): Appraisal Create Date
"Vin"(String): 17 character vehicle identification number
"VehicleSpecYear"(Integer): Year
"VehicleSpecMake"(String): Make
"VehicleSpecModel"(String): Model
"VehicleSpecTrim"(String): Trim
"VehicleSpecMiles"(String): Current Miles
"VehicleSpecEngineSize"(String): Engine Displacement
"VehicleSpecEngineCylinders"(String): Cylinders
"VehicleSpecEngineFuel"(String): Fuel Type
"VehicleSpecDrivetrain"(String): Drive Train
"VehicleSpecTransmission"(String): Transmission
"VehicleSpecBodyStyle"(String): Body Style
"VehicleSpecBodyStyleCab"(String): Truck Cab
"VehicleSpecSegment"(String): Dial Segment
"ImageUrl"(String): Image of the Vehicle
"MyPrice"(Integer): iOffer+ Vehicle Price
Response Errors
403 Vin not provided
403 DealersId not provided
500 Vehicle is Older than 2000
500 Dealer Excluded This Vehicle!
500 Exotic Models Not Bookable
500 Unable to Decode VIN
500 Max vs Min Price Too High (Less than 10k) (edited)
500 Max vs Min Price Too High (10k to 20k) (edited)
500 Max vs Min Price Too High (20k to 30k) (edited)
500 Max vs Min Price Too High (30k to 40k) (edited)
500 Max vs Min Price Too High (40k and Above) (edited)