Developers · Pricing & Valuation API

Pricing & Valuation API for real-world used-car values.

Retail and wholesale values built from live market data and AlgoDriven's proprietary sales history — the same engine behind thousands of dealer appraisals every day. Price one car by VIN or AlgoDriven code, a whole stock list in one batch, or ask for AI Reasoning — a prediction with the reasoning behind it.

Request API accessAll APIs
POST /v1/gccpriceguide · example response
{
  "adcode": "AEAUQ5-16ACAB",
  "highRetail": 75500,
  "lowRetail": 71500,
  "highWholesale": 53500,
  "lowWholesale": 50600,
  "highWholesalePerfect": 60400,
  "lowWholesalePerfect": 57200,
  "currency": "AED"
}
Endpoints

Price one car, or the whole lot.

POST /v1/gccpriceguide

Price Guide

Live retail and wholesale price ranges for a single vehicle, by AlgoDriven code or VIN. Adjust for mileage and GCC/non-GCC spec, choose your market, and back-date the price up to five years with a sale month and year.

POST /v1/price-batch

Price Batch

Submit a whole stock list in one call — each vehicle tagged with your own stock reference. Processing is asynchronous: poll the batch by reference and get per-vehicle values, retail and wholesale prices and confidence ranges once complete.

POST /v1/prediction

AI Reasoning

AI-generated valuation reasoning by AlgoDriven code or VIN — dealer-facing and customer-facing insight bullets that explain what's driving the number, alongside wholesale, retail, buy-to-retail, quick-sale and sweet-spot price predictions with a confidence level.

Coverage

Built for Australia and the GCC.

Live valuations across Australian and GCC markets, expressed in local currency. Values are mileage- and spec-adjusted, with regional market data behind every number — and every vehicle identity resolves through the same AlgoDriven code used by our VIN Decode and Car Catalogue APIs.

Region

Australia & GCC only

All three of our data APIs — VIN Decode, Pricing and Car Catalogue — cover Australia and the six GCC countries. If you need coverage elsewhere, talk to us.

VIN Decode API

Factory VIN (GCC) & (AU)

Factory build, options and spec — resolved from the VIN.

 Car Catalogue API

Every make, model, variant

The full vehicle catalogue behind every AlgoDriven code, per GCC country.
Pricing

Get building fast.

Onboarding

Access within a working day

Talk to our team about what you're building and we'll issue API access so you can build and validate your integration before going live.

Production

Volume & enterprise pricing

Production pricing scales with call volume. Talk to us about volume tiers and enterprise terms.

Quickstart

Your first call.

GCC Price Guide
$ curl -X POST https://algodriven.io/v1/gccpriceguide \
    -H "Authorization: {your-api-key}" \
    -F adcode="AEAUQ5-16ACAB" \
    -F market="AE" \
    -F km=45000

Auth is a single Authorization header on every request. All responses are JSON with standard HTTP status codes. If you don't send a mileage, the guide assumes average mileage for the vehicle's age.

FAQ

Straight answers.

Which regions are covered?

Valuations are available for Australia and the GCC, with values expressed in local currency by region. All three of our data APIs — VIN Decode, Pricing and Car Catalogue — share this same regional coverage.

What values does the API return?

Retail and wholesale price ranges (high/low), wholesale values for perfect-condition vehicles, and — via AI Reasoning — retail, wholesale, buy-to-retail, quick-sale and sweet-spot prices with a confidence level.

Can I price a whole stock list at once?

Yes. The Price Batch endpoint accepts a batch of vehicles — each with your own stock reference — processes them asynchronously, and lets you poll for the full results with a percent-complete status.

Can I get a price for a past date?

Yes — the GCC Price Guide accepts a sale month and year up to five years in the past, and AI Reasoning predictions accept an explicit predict date. Useful for loan-book revaluations, insurance claims and audit work.

Does the API explain its valuations?

Yes. AI Reasoning returns AI-generated valuation reasoning on request — dealer-facing and customer-facing insight bullets that explain what's driving the number. Reasoning generates asynchronously (typically 10–90 seconds) and is polled via a request ID.

What does it cost?

Production pricing scales with volume — contact the API team for a quote and to get access.

Is the API secure and compliant?

Yes. AlgoDriven holds a SOC 2 Type 2 attestation and ISO 27001 certification, and all API traffic is encrypted in transit. Compliance documentation is available on request.

Request API access.

Tell us what you're building — we'll get you set up.

Request API access