vehicle_value_estimate
Estimate the fair market value of a vehicle using make, model, year, trim, mileage, condition, ownership history, location and available market comparables. Returns a valuation range, private-sale estimate, dealer buy/retail estimates, depreciation, transparent valuation adjustments, confidence and risk flags.
When to use
Use this capability when an AI agent needs to estimate the current market value of a passenger vehicle, determine whether an asking price is reasonable, estimate private-sale or dealer values, assess depreciation, or evaluate a vehicle using local or regional market comparables.
Selection guidance
Role: primary. fair-market vehicle valuation; asking-price and trade-in checks; fleet or insurance valuation
Not for: vehicle inspection; vehicle history verification; shipping cost estimation
Use cases
- Estimate the current market value of a used vehicle
- Is this asking price above, below or near market?
- Estimate private-sale value
- Estimate dealer acquisition / trade-in value
- Estimate dealer retail value
- Assess depreciation
- Compare a vehicle with similar market listings
- Vehicle purchase decision support
- Auto-finance and loan-to-value checks
- Insurance valuation workflows
- Fleet and leasing residual checks
- Dealership software
- Vehicle marketplaces and auction platforms
- automotive
Access
- REST:
POST https://api.rafidsystem.com/api/v1/automotive/vehicle-value-estimate - x402:
POST https://api.rafidsystem.com/api/v1/x402/automotive/vehicle-value-estimate - MCP tool:
vehicle_value_estimate - Free preview:
POST https://api.rafidsystem.com/api/v1/preview/vehicle_value_estimate
Price: $0.25 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.
Example input
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 68000,
"condition": "good",
"country": "Oman",
"city": "Muscat",
"currency": "OMR",
"fuelType": "petrol",
"transmission": "automatic",
"bodyType": "suv",
"engine": "4.0L V6",
"drivetrain": "4WD",
"accidentHistory": false,
"serviceHistory": "full",
"owners": 1,
"color": "white",
"options": [
"sunroof",
"leather seats",
"360 camera"
],
"askingPrice": 22500
}Example output
{
"status": "estimated",
"vehicle": {
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 68000,
"condition": "good",
"country": "Oman",
"countryCode": "OM",
"city": "Muscat",
"fuelType": "petrol",
"transmission": "automatic",
"bodyType": "suv",
"drivetrain": "4wd",
"engine": "4.0L V6",
"accidentHistory": "none",
"serviceHistory": "full",
"owners": 1,
"color": "white",
"options": [
"360 camera",
"leather seats",
"sunroof"
],
"ageYears": 5.1,
"expectedMileageKm": 127500,
"mileageVsExpectedPercent": -46.7
},
"valuationDate": "2026-09-23",
"currency": "OMR",
"estimatedValue": {
"low": 22100,
"mid": 23000,
"high": 23900,
"currency": "OMR"
},
"estimatedPrivateSalePrice": 23400,
"estimatedDealerBuyPrice": 20600,
"estimatedDealerRetailPrice": 25700,
"askingPriceAnalysis": {
"askingPrice": 22500,
"differenceFromMid": -500,
"differencePercent": -2.17,
"marketPosition": "near_market",
"withinEstimatedRange": true,
"thresholdsPercent": {
"wellBelow": -15,
"below": -5,
"above": 5,
"wellAbove": 15
}
},
"depreciation": {
"estimatedOriginalPrice": null,
"originalPriceSource": null,
"totalDepreciationAmount": null,
"totalDepreciationPercent": null,
"estimatedAnnualDepreciationPercent": null,
"marketImpliedAnnualDepreciationPercent": null
},
"adjustments": [
{
"factor": "mileage",
"impactAmount": -20,
"impactPercent": -0.1,
"basis": "market_derived",
"reason": "Mileage (68,000 km) is above the comparable-market median (66,000 km); the market-derived mileage effect is -0.53% per 10,000 km."
},
{
"factor": "listing_to_transaction",
"impactAmount": -680,
"impactPercent": -3,
"basis": "heuristic",
"reason": "Comparable prices are listing asking prices; a 3.0% typical negotiation margin for Oman converts them to fair market value."
},
{
"factor": "full_service_history",
"impactAmount": 330,
"impactPercent": 1.5,
"basis": "heuristic",
"reason": "Documented full service history supports stronger resale value."
},
{
"factor": "owner_count",
"impactAmount": 220,
"impactPercent": 1,
"basis": "heuristic",
"reason": "Single owner over several years supports resale value."
},
{
"factor": "major_options",
"impactAmount": 330,
"impactPercent": 1.5,
"basis": "heuristic",
"reason": "Premium equipment (360 camera, leather seats, sunroof) — small, capped uplift; comparables do not report equipment, so this is not market-derived."
}
],
"marketComparables": [
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 71000,
"askingPrice": 23300,
"currency": "OMR",
"originalAskingPrice": 23300,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-dealer-feed",
"sourceUrl": "https://dealer-feed.example/listing/lc-om-3",
"observedAt": "2026-09-14T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.99
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 59000,
"askingPrice": 22400,
"currency": "OMR",
"originalAskingPrice": 22400,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-listings-a",
"sourceUrl": "https://listings-a.example/listing/lc-om-7",
"observedAt": "2026-09-01T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.97
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 62000,
"askingPrice": 23250,
"currency": "OMR",
"originalAskingPrice": 23250,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-listings-a",
"sourceUrl": "https://listings-a.example/listing/lc-om-1",
"observedAt": "2026-09-20T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.97
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 80000,
"askingPrice": 22550,
"currency": "OMR",
"originalAskingPrice": 22550,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-listings-b",
"sourceUrl": "https://listings-b.example/listing/lc-om-5",
"observedAt": "2026-09-08T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.96
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 55000,
"askingPrice": 22700,
"currency": "OMR",
"originalAskingPrice": 22700,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-listings-b",
"sourceUrl": "https://listings-b.example/listing/lc-om-2",
"observedAt": "2026-09-17T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.96
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 52000,
"askingPrice": 22900,
"currency": "OMR",
"originalAskingPrice": 22900,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-dealer-feed",
"sourceUrl": "https://dealer-feed.example/listing/lc-om-9",
"observedAt": "2026-08-23T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.95
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 90000,
"askingPrice": 22800,
"currency": "OMR",
"originalAskingPrice": 22800,
"originalCurrency": "OMR",
"country": "OM",
"city": "Muscat",
"sourceName": "synthetic-listings-a",
"sourceUrl": "https://listings-a.example/listing/lc-om-10",
"observedAt": "2026-08-19T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.94
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 74000,
"askingPrice": 22850,
"currency": "OMR",
"originalAskingPrice": 22850,
"originalCurrency": "OMR",
"country": "OM",
"city": "Nizwa",
"sourceName": "synthetic-listings-b",
"sourceUrl": "https://listings-b.example/listing/lc-om-8",
"observedAt": "2026-08-28T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.94
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 66000,
"askingPrice": 23300,
"currency": "OMR",
"originalAskingPrice": 23300,
"originalCurrency": "OMR",
"country": "OM",
"city": "Salalah",
"sourceName": "synthetic-dealer-feed",
"sourceUrl": "https://dealer-feed.example/listing/lc-om-6",
"observedAt": "2026-09-05T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.93
},
{
"make": "Toyota",
"model": "Land Cruiser",
"year": 2022,
"trim": "GXR",
"mileageKm": 48000,
"askingPrice": 23150,
"currency": "OMR",
"originalAskingPrice": 23150,
"originalCurrency": "OMR",
"country": "OM",
"city": "Sohar",
"sourceName": "synthetic-listings-a",
"sourceUrl": "https://listings-a.example/listing/lc-om-4",
"observedAt": "2026-09-11T12:00:00.000Z",
"priceType": "listing",
"similarityScore": 0.89
}
],
"marketStats": {
"comparableCount": 10,
"comparablesConsidered": 23,
"outliersExcluded": 2,
"medianPrice": 22875,
"averagePrice": 22920,
"medianMileageKm": 64000,
"priceDispersionPercent": 1.6,
"recentListingCount": 8,
"pricePerKmAdjustment": -12.25,
"currencyExcludedCount": 0
},
"methodology": {
"fallbackLevel": "same_trim_same_year",
"fallbackLevelDescription": "Same trim and model year in the local market.",
"outlierMethod": "Tukey IQR fences (1.5×IQR) on log normalized price for n ≥ 5; modified z-score > 3.5 on MAD for n = 4",
"yearEffect": {
"basis": "not_needed",
"annualPercent": null
},
"mileageEffect": {
"basis": "market_derived",
"percentPer10000Km": -0.53
},
"rangeHalfWidthPercent": 4,
"dealerBuyDiscountPercent": 10.5,
"privateSaleAdjustmentPercent": 1.8,
"dealerRetailMarkupPercent": 11.6,
"listingNegotiationDiscountPercent": 3
},
"confidence": {
"score": 0.94,
"level": "high",
"reasons": [
"10 comparable listing(s) used (12+ gives full weight to evidence volume).",
"Mean comparable similarity is 0.95.",
"100% of comparables share the exact trim.",
"Mileage was provided.",
"Median comparable age is 17 day(s).",
"Evidence comes from 3 distinct source(s).",
"Robust price dispersion across comparables is 1.6%."
],
"factors": {
"comparableVolume": 0.83,
"similarity": 0.95,
"trimMatch": 1,
"mileageEvidence": 1,
"locality": 0.94,
"freshness": 1,
"providerDiversity": 1,
"priceConsistency": 0.96
}
},
"riskFlags": [
"HEURISTIC_ADJUSTMENTS_USED",
"OUTLIERS_REMOVED"
],
"assumptions": [
"SYNTHETIC EXAMPLE: generated by the real valuation engine from fictional fixture listings (sources \"synthetic-…\", reserved .example URLs). It illustrates the response shape and method only; it is not a valuation of any real vehicle or market.",
"Vehicle has clear legal ownership/title status with no outstanding finance, liens or registration restrictions.",
"Estimate reflects available market evidence, not a physical inspection or a vehicle-history report.",
"No undisclosed accident or structural damage; the stated accident history was not independently verified.",
"Colour and engine description are recorded but not priced separately.",
"No verified original (new) price reference was available, so total depreciation is not reported."
],
"dataFreshness": {
"latestComparableAt": "2026-09-20T12:00:00.000Z",
"oldestComparableAt": "2026-08-19T12:00:00.000Z",
"medianComparableAgeDays": 17,
"recentListingCount": 8,
"recentWindowDays": 30
},
"marketCoverage": {
"countryCode": "OM",
"country": "Oman",
"region": "gcc",
"valuationParametersConfigured": true,
"marketDataProviders": [
{
"id": "synthetic-oman-listings",
"status": "ok",
"comparablesReturned": 23
}
],
"liveMarketDataAvailable": true,
"regionalFallbackCountries": [
"AE",
"SA",
"QA",
"BH",
"KW"
]
},
"vinCheck": null,
"currencyConversion": {
"resultCurrency": "OMR",
"sourcesConfigured": [],
"conversions": []
},
"disclaimer": "Estimate derived from available market evidence using deterministic methods. It is not a physical inspection, a vehicle-history check, a formal appraisal, or a guarantee of sale price, and it is not financial, lending or insurance advice."
}Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"make": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "Manufacturer, e.g. Toyota. Required. Common aliases are normalized (VW → Volkswagen, Mercedes → Mercedes-Benz)."
},
"model": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Model, e.g. Land Cruiser. Required."
},
"year": {
"type": "integer",
"minimum": 1950,
"maximum": 2027,
"description": "Model year (1950–next calendar year). Required."
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Market the vehicle is sold in — ISO 3166 alpha-2 (e.g. OM, AE, US, GB) or country name. Required."
},
"trim": {
"description": "Trim / grade, e.g. GXR, VXR, XLE. Strongly recommended — trim-level comparables are preferred over model-level ones.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"mileageKm": {
"description": "Odometer reading in kilometres. Strongly recommended — without it no mileage adjustment is possible and confidence drops.",
"type": "integer",
"minimum": 0,
"maximum": 2000000
},
"condition": {
"description": "Overall condition: excellent, very_good, good, fair, poor or unknown. Strongly recommended.",
"type": "string",
"enum": [
"excellent",
"very_good",
"good",
"fair",
"poor",
"unknown"
]
},
"city": {
"description": "City or region, e.g. Muscat. Strongly recommended — same-city comparables score higher.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"currency": {
"description": "Result currency (ISO 4217). Defaults to the market's local currency; askingPrice is interpreted in this currency.",
"type": "string",
"minLength": 1,
"maxLength": 8
},
"fuelType": {
"description": "petrol, diesel, hybrid, plug_in_hybrid, electric, lpg, cng, hydrogen or other (synonyms such as gasoline accepted).",
"type": "string",
"enum": [
"petrol",
"diesel",
"hybrid",
"plug_in_hybrid",
"electric",
"lpg",
"cng",
"hydrogen",
"other"
]
},
"transmission": {
"description": "automatic, manual, cvt, dct or other.",
"type": "string",
"enum": [
"automatic",
"manual",
"cvt",
"dct",
"other"
]
},
"bodyType": {
"description": "sedan, hatchback, suv, crossover, pickup, coupe, convertible, wagon, van, minivan or other.",
"type": "string",
"enum": [
"sedan",
"hatchback",
"suv",
"crossover",
"pickup",
"coupe",
"convertible",
"wagon",
"van",
"minivan",
"other"
]
},
"engine": {
"description": "Engine description, e.g. 4.0L V6 (recorded; not priced separately).",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"drivetrain": {
"description": "fwd, rwd, awd or 4wd.",
"type": "string",
"enum": [
"fwd",
"rwd",
"awd",
"4wd"
]
},
"accidentHistory": {
"description": "false / \"none\" = no known accident; \"minor_cosmetic\", \"repaired\", \"structural\"; true / \"reported\" = an accident with unstated severity; \"unknown\".",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"none",
"minor_cosmetic",
"repaired",
"structural",
"reported",
"unknown"
]
}
]
},
"serviceHistory": {
"description": "full, partial, none or unknown.",
"type": "string",
"enum": [
"full",
"partial",
"none",
"unknown"
]
},
"owners": {
"description": "Number of previous registered owners (1–20).",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"color": {
"description": "Exterior colour (recorded; not priced separately).",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"options": {
"description": "Notable equipment, e.g. [\"sunroof\", \"leather seats\", \"360 camera\"] (max 40).",
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
}
},
"vin": {
"description": "Optional 17-character VIN. Validated (and decoded when the deployment enables a VIN decoder) to confirm make/model/year, fill missing trim/body/fuel/drivetrain, and exclude the vehicle's own listing from its comparables. Never stored or logged; returned masked.",
"type": "string"
},
"askingPrice": {
"description": "Asking price to assess, in `currency` (or the market currency). Adds askingPriceAnalysis with the exact difference from the estimated midpoint.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000000
},
"valuationDate": {
"description": "Optional as-of date (YYYY-MM-DD, not in the future). Defaults to today (UTC). Market evidence observed after this date is ignored — useful for insurance or historical valuation.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"make",
"model",
"year",
"country"
],
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"estimated",
"insufficient_market_data"
]
},
"vehicle": {
"type": "object",
"properties": {
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"year": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"trim": {
"type": [
"string",
"null"
]
},
"mileageKm": {
"type": [
"number",
"null"
]
},
"condition": {
"type": "string",
"enum": [
"excellent",
"very_good",
"good",
"fair",
"poor",
"unknown"
]
},
"country": {
"type": "string"
},
"countryCode": {
"type": "string"
},
"city": {
"type": [
"string",
"null"
]
},
"fuelType": {
"anyOf": [
{
"type": "string",
"enum": [
"petrol",
"diesel",
"hybrid",
"plug_in_hybrid",
"electric",
"lpg",
"cng",
"hydrogen",
"other"
]
},
{
"type": "null"
}
]
},
"transmission": {
"anyOf": [
{
"type": "string",
"enum": [
"automatic",
"manual",
"cvt",
"dct",
"other"
]
},
{
"type": "null"
}
]
},
"bodyType": {
"anyOf": [
{
"type": "string",
"enum": [
"sedan",
"hatchback",
"suv",
"crossover",
"pickup",
"coupe",
"convertible",
"wagon",
"van",
"minivan",
"other"
]
},
{
"type": "null"
}
]
},
"drivetrain": {
"anyOf": [
{
"type": "string",
"enum": [
"fwd",
"rwd",
"awd",
"4wd"
]
},
{
"type": "null"
}
]
},
"engine": {
"type": [
"string",
"null"
]
},
"accidentHistory": {
"type": "string",
"enum": [
"none",
"minor_cosmetic",
"repaired",
"structural",
"reported",
"unknown"
]
},
"serviceHistory": {
"type": "string",
"enum": [
"full",
"partial",
"none",
"unknown"
]
},
"owners": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"color": {
"type": [
"string",
"null"
]
},
"options": {
"type": "array",
"items": {
"type": "string"
}
},
"ageYears": {
"type": "number"
},
"expectedMileageKm": {
"type": [
"number",
"null"
]
},
"mileageVsExpectedPercent": {
"type": [
"number",
"null"
]
}
},
"required": [
"make",
"model",
"year",
"trim",
"mileageKm",
"condition",
"country",
"countryCode",
"city",
"fuelType",
"transmission",
"bodyType",
"drivetrain",
"engine",
"accidentHistory",
"serviceHistory",
"owners",
"color",
"options",
"ageYears",
"expectedMileageKm",
"mileageVsExpectedPercent"
],
"additionalProperties": false
},
"valuationDate": {
"type": "string"
},
"currency": {
"type": "string"
},
"estimatedValue": {
"anyOf": [
{
"type": "object",
"properties": {
"low": {
"type": "number"
},
"mid": {
"type": "number"
},
"high": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"low",
"mid",
"high",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"estimatedPrivateSalePrice": {
"type": [
"number",
"null"
]
},
"estimatedDealerBuyPrice": {
"type": [
"number",
"null"
]
},
"estimatedDealerRetailPrice": {
"type": [
"number",
"null"
]
},
"askingPriceAnalysis": {
"anyOf": [
{
"type": "object",
"properties": {
"askingPrice": {
"type": "number"
},
"differenceFromMid": {
"type": "number"
},
"differencePercent": {
"type": "number"
},
"marketPosition": {
"type": "string",
"enum": [
"well_below_market",
"below_market",
"near_market",
"above_market",
"well_above_market"
]
},
"withinEstimatedRange": {
"type": "boolean"
},
"thresholdsPercent": {
"type": "object",
"properties": {
"wellBelow": {
"type": "number"
},
"below": {
"type": "number"
},
"above": {
"type": "number"
},
"wellAbove": {
"type": "number"
}
},
"required": [
"wellBelow",
"below",
"above",
"wellAbove"
],
"additionalProperties": false
}
},
"required": [
"askingPrice",
"differenceFromMid",
"differencePercent",
"marketPosition",
"withinEstimatedRange",
"thresholdsPercent"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"depreciation": {
"type": "object",
"properties": {
"estimatedOriginalPrice": {
"type": [
"number",
"null"
]
},
"originalPriceSource": {
"type": [
"string",
"null"
]
},
"totalDepreciationAmount": {
"type": [
"number",
"null"
]
},
"totalDepreciationPercent": {
"type": [
"number",
"null"
]
},
"estimatedAnnualDepreciationPercent": {
"type": [
"number",
"null"
]
},
"marketImpliedAnnualDepreciationPercent": {
"type": [
"number",
"null"
]
}
},
"required": [
"estimatedOriginalPrice",
"originalPriceSource",
"totalDepreciationAmount",
"totalDepreciationPercent",
"estimatedAnnualDepreciationPercent",
"marketImpliedAnnualDepreciationPercent"
],
"additionalProperties": false
},
"adjustments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"factor": {
"type": "string"
},
"impactAmount": {
"type": "number"
},
"impactPercent": {
"type": "number"
},
"basis": {
"type": "string",
"enum": [
"market_derived",
"heuristic"
]
},
"reason": {
"type": "string"
}
},
"required": [
"factor",
"impactAmount",
"impactPercent",
"basis",
"reason"
],
"additionalProperties": false
}
},
"marketComparables": {
"type": "array",
"items": {
"type": "object",
"properties": {
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"year": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"trim": {
"type": [
"string",
"null"
]
},
"mileageKm": {
"type": [
"number",
"null"
]
},
"askingPrice": {
"type": "number"
},
"currency": {
"type": "string"
},
"originalAskingPrice": {
"type": "number"
},
"originalCurrency": {
"type": "string"
},
"country": {
"type": "string"
},
"city": {
"type": [
"string",
"null"
]
},
"sourceName": {
"type": "string"
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"priceType": {
"type": "string",
"enum": [
"listing",
"sale"
]
},
"similarityScore": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"make",
"model",
"year",
"trim",
"mileageKm",
"askingPrice",
"currency",
"originalAskingPrice",
"originalCurrency",
"country",
"city",
"sourceName",
"sourceUrl",
"observedAt",
"priceType",
"similarityScore"
],
"additionalProperties": false
}
},
"marketStats": {
"type": "object",
"properties": {
"comparableCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"comparablesConsidered": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"outliersExcluded": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"medianPrice": {
"type": [
"number",
"null"
]
},
"averagePrice": {
"type": [
"number",
"null"
]
},
"medianMileageKm": {
"type": [
"number",
"null"
]
},
"priceDispersionPercent": {
"type": [
"number",
"null"
]
},
"recentListingCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"pricePerKmAdjustment": {
"type": [
"number",
"null"
]
},
"currencyExcludedCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"comparableCount",
"comparablesConsidered",
"outliersExcluded",
"medianPrice",
"averagePrice",
"medianMileageKm",
"priceDispersionPercent",
"recentListingCount",
"pricePerKmAdjustment",
"currencyExcludedCount"
],
"additionalProperties": false
},
"methodology": {
"type": "object",
"properties": {
"fallbackLevel": {
"anyOf": [
{
"type": "string",
"enum": [
"same_trim_same_year",
"same_trim_year_plus_minus_1",
"same_model_year_plus_minus_1",
"same_model_year_plus_minus_2",
"regional_same_model_year_plus_minus_2"
]
},
{
"type": "null"
}
]
},
"fallbackLevelDescription": {
"type": [
"string",
"null"
]
},
"outlierMethod": {
"type": "string"
},
"yearEffect": {
"type": "object",
"properties": {
"basis": {
"type": "string",
"enum": [
"market_derived",
"heuristic",
"not_needed"
]
},
"annualPercent": {
"type": [
"number",
"null"
]
}
},
"required": [
"basis",
"annualPercent"
],
"additionalProperties": false
},
"mileageEffect": {
"type": "object",
"properties": {
"basis": {
"type": "string",
"enum": [
"market_derived",
"heuristic",
"not_applied"
]
},
"percentPer10000Km": {
"type": [
"number",
"null"
]
}
},
"required": [
"basis",
"percentPer10000Km"
],
"additionalProperties": false
},
"rangeHalfWidthPercent": {
"type": [
"number",
"null"
]
},
"dealerBuyDiscountPercent": {
"type": [
"number",
"null"
]
},
"privateSaleAdjustmentPercent": {
"type": [
"number",
"null"
]
},
"dealerRetailMarkupPercent": {
"type": [
"number",
"null"
]
},
"listingNegotiationDiscountPercent": {
"type": [
"number",
"null"
]
}
},
"required": [
"fallbackLevel",
"fallbackLevelDescription",
"outlierMethod",
"yearEffect",
"mileageEffect",
"rangeHalfWidthPercent",
"dealerBuyDiscountPercent",
"privateSaleAdjustmentPercent",
"dealerRetailMarkupPercent",
"listingNegotiationDiscountPercent"
],
"additionalProperties": false
},
"confidence": {
"type": "object",
"properties": {
"score": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"level": {
"type": "string",
"enum": [
"high",
"medium",
"low",
"very_low"
]
},
"reasons": {
"type": "array",
"items": {
"type": "string"
}
},
"factors": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number",
"minimum": 0,
"maximum": 1
}
}
},
"required": [
"score",
"level",
"reasons",
"factors"
],
"additionalProperties": false
},
"riskFlags": {
"type": "array",
"items": {
"type": "string",
"enum": [
"INSUFFICIENT_COMPARABLES",
"NO_MARKET_DATA_PROVIDER",
"STALE_MARKET_DATA",
"HIGH_PRICE_DISPERSION",
"MILEAGE_UNKNOWN",
"TRIM_UNKNOWN",
"CONDITION_UNKNOWN",
"ACCIDENT_HISTORY_UNKNOWN",
"ACCIDENT_SEVERITY_UNVERIFIED",
"STRUCTURAL_DAMAGE_REPORTED",
"HIGH_MILEAGE_FOR_AGE",
"ASKING_PRICE_SIGNIFICANTLY_ABOVE_MARKET",
"ASKING_PRICE_SIGNIFICANTLY_BELOW_MARKET",
"CURRENCY_CONVERSION_UNAVAILABLE",
"REGIONAL_FALLBACK_USED",
"BROADENED_COMPARABLE_SEARCH",
"HEURISTIC_ADJUSTMENTS_USED",
"PROVIDER_PARTIAL_FAILURE",
"OUTLIERS_REMOVED",
"VIN_MISMATCH",
"VIN_CHECK_DIGIT_INVALID",
"VIN_DECODE_UNAVAILABLE",
"SUBJECT_LISTING_EXCLUDED"
]
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"dataFreshness": {
"type": "object",
"properties": {
"latestComparableAt": {
"type": [
"string",
"null"
]
},
"oldestComparableAt": {
"type": [
"string",
"null"
]
},
"medianComparableAgeDays": {
"type": [
"number",
"null"
]
},
"recentListingCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"recentWindowDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"latestComparableAt",
"oldestComparableAt",
"medianComparableAgeDays",
"recentListingCount",
"recentWindowDays"
],
"additionalProperties": false
},
"marketCoverage": {
"type": "object",
"properties": {
"countryCode": {
"type": "string"
},
"country": {
"type": "string"
},
"region": {
"type": "string"
},
"valuationParametersConfigured": {
"type": "boolean"
},
"marketDataProviders": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"ok",
"empty",
"timeout",
"error"
]
},
"comparablesReturned": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id",
"status",
"comparablesReturned"
],
"additionalProperties": false
}
},
"liveMarketDataAvailable": {
"type": "boolean"
},
"regionalFallbackCountries": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"countryCode",
"country",
"region",
"valuationParametersConfigured",
"marketDataProviders",
"liveMarketDataAvailable",
"regionalFallbackCountries"
],
"additionalProperties": false
},
"vinCheck": {
"anyOf": [
{
"type": "object",
"properties": {
"vinMasked": {
"type": "string"
},
"wmiRegion": {
"type": "string",
"enum": [
"north_america",
"south_america",
"europe",
"asia",
"africa",
"oceania",
"unknown"
]
},
"checkDigit": {
"type": "string",
"enum": [
"valid",
"invalid",
"not_applicable"
]
},
"decoder": {
"type": "string"
},
"decodeStatus": {
"type": "string",
"enum": [
"decoded",
"not_decoded",
"unavailable",
"not_configured"
]
},
"decoded": {
"type": "object",
"properties": {
"make": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"modelYear": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"trim": {
"type": [
"string",
"null"
]
},
"bodyClass": {
"type": [
"string",
"null"
]
},
"fuelType": {
"type": [
"string",
"null"
]
},
"driveType": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"engine": {
"type": [
"string",
"null"
]
}
},
"required": [
"make",
"model",
"modelYear",
"trim",
"bodyClass",
"fuelType",
"driveType",
"transmission",
"engine"
],
"additionalProperties": false
},
"matches": {
"type": "object",
"properties": {
"make": {
"type": [
"boolean",
"null"
]
},
"model": {
"type": [
"boolean",
"null"
]
},
"year": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"make",
"model",
"year"
],
"additionalProperties": false
},
"enrichedFields": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"vinMasked",
"wmiRegion",
"checkDigit",
"decoder",
"decodeStatus",
"decoded",
"matches",
"enrichedFields",
"notes"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"currencyConversion": {
"type": "object",
"properties": {
"resultCurrency": {
"type": "string"
},
"sourcesConfigured": {
"type": "array",
"items": {
"type": "string"
}
},
"conversions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"rate": {
"type": "number",
"exclusiveMinimum": 0
},
"source": {
"type": "string"
},
"rateDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"from",
"to",
"rate",
"source",
"rateDate"
],
"additionalProperties": false
}
}
},
"required": [
"resultCurrency",
"sourcesConfigured",
"conversions"
],
"additionalProperties": false
},
"disclaimer": {
"type": "string"
}
},
"required": [
"status",
"vehicle",
"valuationDate",
"currency",
"estimatedValue",
"estimatedPrivateSalePrice",
"estimatedDealerBuyPrice",
"estimatedDealerRetailPrice",
"askingPriceAnalysis",
"depreciation",
"adjustments",
"marketComparables",
"marketStats",
"methodology",
"confidence",
"riskFlags",
"assumptions",
"dataFreshness",
"marketCoverage",
"vinCheck",
"currencyConversion",
"disclaimer"
],
"additionalProperties": false
}Category: Automotive Intelligence · hierarchy: primary · idempotent: yes · side effects: no