Back to Dashboard

AlgoDriven API Docs

Partner APIs for vehicle appraisals, inspections, VIN decode, pricing intelligence, and outbound webhooks. Keys are region-scoped (AU, US, GCC). Either build on top of our platforms (EvalExpert, DriveExpert or InspectExpert) or develop from the ground up with our market data APIs.

Get started in 4 steps

Sandbox first. Production keys are issued from the same Developer portal once you are ready.

Request sandbox access Open the dashboard Developer page and create or request a sandbox key for your market.
Pick a pack EvalExpert for appraisals, DriveExpert for drive webhooks, InspectExpert for inspection bookings, or AU / GCC for data-only VIN and pricing calls.
Call with your key Send Authorization: <api_key> — the raw key, no Bearer prefix.
Go live Promote to a production key from the dashboard when your integration is ready.

Authentication and base URLs

Auth header

Every request needs:

Authorization: your_api_key

Do not send a Bearer prefix. To act as a specific rooftop on EvalExpert or DriveExpert, see Accessing a dealer below.

Base URLs

  • EvalExpert / DriveExpert / InspectExpert — https://evalexpert.io/v1
  • AU / GCC data APIs — https://algodriven.io/v1
  • Pricing AI (/prediction) — https://pricingai.algodriven.io/v1

Accessing a dealer

EvalExpert and DriveExpert only. AU / GCC data APIs are keyed to a market, not a rooftop. Two ways to run a request as a given dealer:

Legacy — dedicated API key

Issue one API key per rooftop. That key is bound to the dealer, so every call already runs as that rooftop.

Do not send X-Dealer-Id. Existing single-dealer integrations keep working this way.

New — X-Dealer-Id header

Issue one partner key that covers several rooftops. On every request send:

X-Dealer-Id: dealer_uid

The value is the rooftop's uid, not the numeric DealerID. Required when the key is not bound to a single dealer; ignored on a dedicated (single-dealer) key. The key must be authorised for that rooftop.

InspectExpert supports dedicated keys only: issue one key per rooftop and do not send X-Dealer-Id.

Sandbox

Sandbox keys share the same paths as production.

Webhooks

EvalExpert and DriveExpert receivers are self-serve via POST /partner/webhooks (type eval or drive). Deliveries are signed with X-AlgoDriven-Signature over {timestamp}.{raw_json_body}; the timestamp is in X-AlgoDriven-Timestamp.

  • EvalExpert — ON_COMPLETE, ON_EXPORT (body = /geteval). Details in EvalExpert.
  • DriveExpert — ON_DRIVE_COMPLETED. Details in DriveExpert.
  • GCC price batch — completion can also be delivered as a price_batch webhook. That type is not self-serve on /partner/webhooks (AlgoDriven attaches it). Poll GET /price-batch/{batchRef} otherwise. Details in GCC Data APIs.

Products

Application APIs for appraisals, drive-completed events, and vehicle inspections.

EvalExpertEvalExpert APIAppraisals, stock sync, and evaluation webhooks for AU, US, and GCC keys.https://evalexpert.io/v118 endpointsOpen docsOpenAPI JSON
DriveExpertDriveExpert APIDrive-completed webhooks for DriveExpert.https://evalexpert.io/v12 endpointsOpen docsOpenAPI JSON
InspectExpertInspectExpert APIBook vehicle inspections, read inspection reports, and cancel bookings.https://evalexpert.io/v13 endpointsOpen docsOpenAPI JSON

Market data APIs

VIN decode and pricing data feeds by market. Separate from EvalExpert appraisal flows.

AustraliaAU Data APIsVIN Decoding, Pricing AI, and related AU data endpoints.https://algodriven.io/v13 endpointsOpen docsOpenAPI JSON
GCC / MENAGCC Data APIsFactory VIN, Price Guide, Pricing AI, and related GCC endpoints.https://algodriven.io/v17 endpointsOpen docsOpenAPI JSON