UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Retail Market Value (Canada)

Powered by VIN Audit

Understand What a Vehicle Is Worth in Today's Canadian Retail Market

Access data-driven Canadian retail vehicle valuations based on sales listings, providing a transparent view of market pricing and the underlying data behind each valuation.

The Retail Market Value API provides low, average and high retail values alongside pricing distributions, valuation adjustments and supporting sales listings—helping automotive businesses price, value and assess vehicles with greater confidence.

Key Features

Vehicle Identification

Identifies key vehicle attributes including make, model, trim, year and fuel type, providing the foundation for an accurate market valuation.

Retail Market Value

Access low, average and high retail market values calculated from an identified number of comparable sales listings, together with a confidence level indicating the strength of the valuation.

Sale Price Distribution

Understand how comparable vehicle listings are distributed across up to 10 price bands, providing greater context than a single valuation and a clearer picture of the wider retail market.

Valuation Adjustments

See clearly identified adjustments for mileage, condition, vehicle history and previous damage, providing greater insight into how individual vehicle valuations have been arrived at.

Sales Listings

See the data behind the valuation. Underlying sales listings provide full transparency and market evidence to support the valuation.

Updated Daily

Keep pace with a changing market - valuations are updated daily, ensuring valuations respond to changes in supply, advertised pricing and wider market conditions.

Pricing

PAYG
72p
Per Use
Business
48p
Per Use
Enterprise
24p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)72p82c90c
Business (Per Use)48p55c60c
Enterprise (Per Use)24p27c30c

Documentation

Introduction

TODO

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/vinaudit/retailmarketvalue/canada?vehicle_identification_number=2C3CDXCT8PH111111&current_mileage=12345&sales_history_days=90&previous_damage=minor_damage&vehicle_condition=like_new

Example Sandbox Request

https://sandbox.oneautoapi.com/vinaudit/retailmarketvalue/canada?vehicle_identification_number=2C3CDXCT8PH111111&current_mileage=12345&sales_history_days=90&previous_damage=minor_damage&vehicle_condition=like_new

Request Parameters

vehicle_identification_number
mandatory, string, e.g. 2C3CDXCT8PH111111
Vehicle identification number (VIN).
current_mileage
mandatory, string, e.g. 12345
Current mileage of the vehicle.
sales_history_days
optional, string, e.g. 90
The number of days sales history used to calculate the valuation.
previous_damage
optional, string, e.g. minor_damage
Possible values are: frame_damage (major structural damage), airbags_deployed (airbag deployment history), salvage (salvage title history), brand (branded title), rollback (odometer rollback), minor_damage (minor accident damage), lemon (lemon law vehicle), rental (former rental vehicle), prior_theft (vehicle has prior theft history)
vehicle_condition
optional, string, e.g. like_new
Possible values are: average, like_new, not_great

Sample Response

{
  "success": true,
  "result": {
    "vehicle_data": {
      "vehicle_identification_number": "2C3CDXCT8PH111111",
      "vehicle_desc": "2023 Dodge Charger R/T",
      "manufacturer_desc": "Dodge",
      "model_range_desc": "Charger",
      "trim_desc": "R/T",
      "model_year": 2023,
      "fuel_type_desc": "Gas"
    },
    "pricing_data": {
      "mean_valuation_cad": 32345.86,
      "standard_deviation_cad": 6087,
      "sale_prices_count": 43,
      "confidence_level": 99,
      "sale_date_from": "2026-06-13",
      "sale_date_to": "2026-09-06",
      "retail_high_valuation_cad": 36845.04,
      "retail_average_valuation_cad": 32345.86,
      "retail_low_valuation_cad": 27846.68
    },
    "distribution_data": [
      {
        "sale_prices_count": 5,
        "sale_price_max": 28826,
        "sale_price_min": 24303
      }
    ],
    "adjustments_data": {
      "mileage_adjustment": -2601,
      "history_adjustment": 0,
      "condition_adjustment": 4284,
      "damage_adjustment": -15700
    },
    "sales_data": [
      {
        "sale_date": "2026-06-17",
        "vehicle_identification_number": "2C3CDXCT8PH222222",
        "engine_desc": "5.7",
        "fuel_type_desc": "Gas",
        "mileage_observed": 14538,
        "advertised_price_cad": 49900,
        "mileage_adjusted_price_cad": 44580.7,
        "zip_code": "T8N 7X1",
        "state_code": "AB",
        "latitude": "53.6754331",
        "longitude": "-113.6376403"
      }
    ]
  }
}

Response Parameters

success
e.g. true
Whether the api call was successful
vehicle_identification_number
e.g. 2C3CDXCT8PH111111
Vehicle identification number (VIN).
vehicle_desc
e.g. 2023 Dodge Charger R/T
The Vehicle description
manufacturer_desc
e.g. Dodge
Manufacturer description
model_range_desc
e.g. Charger
Model range description.
trim_desc
e.g. R/T
Trim description
model_year
e.g. 2023
Model Year
fuel_type_desc
e.g. Gas
The vehicle's fuel type description
mean_valuation_cad
e.g. 32345.86
The average (mean) valuation in Canadian dollars.
standard_deviation_cad
e.g. 6087
Standard deviation in Canadian dollars.
sale_prices_count
e.g. 43
The number of sale prices used to calculate the valuation.
confidence_level
e.g. 99
Confidence level (0-100)
sale_date_from
e.g. 2026-06-13
The earliest date of the sale prices used to calculate the valuation.
sale_date_to
e.g. 2026-09-06
The latest date of the sale prices used to calculate the valuation.
retail_high_valuation_cad
e.g. 36845.04
High retail valuation in Canadian dollars.
retail_average_valuation_cad
e.g. 32345.86
Average retail valuation in Canadian dollars.
retail_low_valuation_cad
e.g. 27846.68
Low retail valuation in Canadian dollars.
sale_prices_count
e.g. 5
The number of sale prices used to calculate the valuation.
sale_price_max
e.g. 28826
The maximum sale price in this segment of sale prices.
sale_price_min
e.g. 24303
The minimum sale price in this segment of sale prices.
mileage_adjustment
e.g. -2601
Adjustment made for mileage.
history_adjustment
e.g. 0
Adjustment made for vehicle history.
condition_adjustment
e.g. 4284
Adjustment made for vehicle condition.
damage_adjustment
e.g. -15700
Adjustment made for damage.
sale_date
e.g. 2026-06-17
Date of sale.
vehicle_identification_number
e.g. 2C3CDXCT8PH222222
Vehicle identification number (VIN).
engine_desc
e.g. 5.7
Engine description
fuel_type_desc
e.g. Gas
The vehicle's fuel type description
mileage_observed
e.g. 14538
Vehicle odometer reading
advertised_price_cad
e.g. 49900
Advertised price in Canadian dollars.
mileage_adjusted_price_cad
e.g. 44580.7
Advertised price, adjusted for mileage in Canadian dollars.
zip_code
e.g. T8N 7X1
ZIP Code for the centre of the search for comparables.
state_code
e.g. AB
The state code.
latitude
e.g. 53.6754331
Latitude
longitude
e.g. -113.6376403
Longitude

Status Codes

200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From VIN Audit