Price Guide

Get a GCC price guide valuation

Returns the vehicle's price prediction for a supported GCC (or related) market, identified by an AlgoDriven code or a VIN. Either adcode or vin is required.

post/gccpriceguide

Request

  • Base URL: https://algodriven.io/v1
  • URL: https://algodriven.io/v1/gccpriceguide
  • Auth: API key in header authorization

Request body

adcodestring

An AlgoDriven vehicle identification code. Can either be a full 13 character code, or a short 9 digit code (make, model and year only).

vinstring

Vehicle Identification Number, used as an alternative to adcode. Lookup by VIN may incur additional charges and requires activation.

kminteger

The number of kilometres the car has travelled that the price guide will take into account. If no km value is sent, the API will return a price guide for a car of average mileage.

nonGcc0 | 1

Denotes whether the car is non-GCC spec. If 1, returns a price guide for a non-GCC spec car. If omitted, or 0, returns a price guide for a GCC spec car.

market'AE' | 'UAE' | 'OM' | 'SA' | 'QA' | 'KW' | 'BH' | 'IQ' | 'DXB' | 'AUH'

The market which the prediction is being generated for.

saleMonthinteger

The month when the predicted price is made. Can be up to five years in the past from the current month. If not specified, returns the current price for the current month (today). Should be used with saleYear.

saleYearinteger

The year when the predicted price is made. Can be up to five years in the past from the current year. If not specified, returns the current price for the current year (today). Should be used with saleMonth.

Example request

{
  "adcode": "AEAUQ5-16ACAB"
}

Response

The vehicle's price prediction.

devboolean

Whether this valuation was served from a development/test pricing environment rather than production.

adcodestring

AlgoDriven code the valuation was resolved against.

highRetailnumber

Max retail price.

lowRetailnumber

Min retail price.

highWholesalenumber

Max wholesale price in average condition. Omitted for some dealer accounts.

lowWholesalenumber

Min wholesale price in average condition. Omitted for some dealer accounts.

highWholesalePerfectnumber

Max wholesale price in perfect condition.

lowWholesalePerfectnumber

Min wholesale price in perfect condition.

highMileagenumber

Upper bound of the forecasted mileage range. Omitted for some dealer accounts.

lowMileagenumber

Lower bound of the forecasted mileage range. Omitted for some dealer accounts.

carNotFoundboolean

True if the supplied AlgoDriven code / VIN could not be matched to a vehicle.

currencystring

Currency of the returned price range, based on market (e.g. AED, SAR, OMR, KWD, QAR, BHD, USD, HKD).

Changes

No recorded changes to this operation across all 1 revision of this API.