Valuation: getting the market value of a car
The valuation is the most important request of the API. You send the details of a car and get its market value in Swiss francs, the range and how certain the value is. If you wish, also how many cars of the same model are listed right now.
curl -X POST https://prisradar.ch/api/v1/valuations \
-H "Authorization: Bearer $PRISRADAR_KEY" \
-H "Content-Type: application/json" \
-d '{
"make": "Audi",
"model": "Q5",
"year": 2021,
"mileageKm": 50000,
"fuel": "diesel",
"transmission": "automatic",
"powerKw": 140,
"drive": "awd",
"include": [
"market"
]
}'{
"id": "val_kglReIcl8Sw0",
"test": false,
"vehicle": {
"make": "Audi",
"model": "Q5",
"year": 2021,
"mileageKm": 50000,
"fuel": "diesel",
"transmission": "automatic"
},
"value": {
"chf": 34600,
"low": 28400,
"high": 42100,
"basis": "asking_prices"
},
"confidence": {
"level": "hoch",
"score": 0.84
},
"comparables": {
"count": 10,
"closeness": "eng",
"level": "configuration"
},
"notes": [],
"attribution": {
"text": "Preisorientierung von prisradar.ch",
"url": "https://prisradar.ch"
},
"dataAsOf": "2026-10-13T00:21:50.494Z",
"market": {
"activeListings": 1269,
"medianDaysOnline": 48
}
}What details do I send?
Required are make, model, year, mileageKm, fuel and transmission. Power, drive, body type, seller and condition are optional. The more details, the more closely the comparable listings match and the more certain the value. Without a seller, the API assumes a dealer. Optional fields may be missing or null.
POSThttps://prisradar.ch/api/v1/valuations
| Field | Type | Meaning |
|---|---|---|
makeRequired | string | Make, in any spelling: Audi, Mercedes-Benz, VW. |
modelRequired | string | Model as in the catalogue, for example Q5 or Golf. |
yearRequired | integer | Year of first registration. Cars older than 25 years get no value. |
mileageKmRequired | integer | Mileage, 0 to 999999. |
fuelRequired | enum | petrol diesel hybrid electric gas |
transmissionRequired | enum | manual automatic |
powerKw | integer | Power in kW. Alternatively powerHp in hp. |
drive | enum | fwd rwd awd |
bodyType | enum | small sedan wagon suv coupe convertible van |
seller | enum | dealer or private. If omitted: dealer. |
condition.accident | boolean | Accident vehicle: the value and the confidence drop; notes states the deduction. |
condition.damage | boolean | Visible damage: the value drops; notes states the deduction. |
include | array | ["market"] also returns market. |
What is in the response?
value.chf is the market value in Swiss francs, value.low and value.high the range in which most comparable offers lie. confidence says how certain the value is, comparables how many listings support it. notes contains notes in German, attribution the text and link that must appear with the value.
| Field | Type | Meaning |
|---|---|---|
value.chf | integer | Market value in Swiss francs, rounded to 100. |
value.low · value.high | integer | The range in which most comparable offers lie. |
value.basis | string | Always asking_prices: asking prices from listings. |
confidence.level | enum | hoch (high) from 0.7, mittel (medium) from 0.5, otherwise tief (low). Plus score from 0 to 1. |
comparables.count | integer | How many similar listings support the value, at least 3. |
comparables.closeness | enum | eng (close): all near the car. weit (wide): the circle had to be widened. |
comparables.level | enum | configuration: same fuel and transmission. model: the whole model. |
market | object | Only with include: activeListings listed right now, medianDaysOnline median time online in days. |
notes | string[] | Notes in German, for example about a deduction for an accident. |
attribution | object | Text and link that must appear with the value. |
dataAsOf | string | When the prices of the comparable listings were last recalculated. |
How do I read the confidence?
confidence.level sums up how well the value is supported: hoch (high), mittel (medium) or tief (low). It depends on how many comparable listings there are and how close they are to the car. With tief, show a note next to the value or leave it out, depending on what your software needs it for.
What happens if there is no value?
If the catalogue does not know the make or the model, you get 404 with suggestions in error.suggestions. If there are too few similar listings, you get 422 too_few_comparables; that is not a fault in your software, rare cars often have too few comparisons. Neither counts towards the quota.
{
"error": {
"code": "unknown_make",
"message": "Die Marke «Ferari» kennen wir nicht.",
"suggestions": [
"Ferrari"
]
}
}{
"error": {
"code": "too_few_comparables",
"message": "Zu wenige ähnliche Inserate für einen sicheren Wert.",
"comparables": {
"count": 2,
"needed": 3
}
}
}Didn’t find what you’re looking for?Write to info@prisradar.ch or use the contact form.