Prisradar
Endpoints

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.

Updated on 21.10.2026The Prisradar team

On this page
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"
    ]
  }'
Response 200
{
  "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

FieldTypeMeaning
makeRequiredstringMake, in any spelling: Audi, Mercedes-Benz, VW.
modelRequiredstringModel as in the catalogue, for example Q5 or Golf.
yearRequiredintegerYear of first registration. Cars older than 25 years get no value.
mileageKmRequiredintegerMileage, 0 to 999999.
fuelRequiredenumpetrol diesel hybrid electric gas
transmissionRequiredenummanual automatic
powerKwintegerPower in kW. Alternatively powerHp in hp.
driveenumfwd rwd awd
bodyTypeenumsmall sedan wagon suv coupe convertible van
sellerenumdealer or private. If omitted: dealer.
condition.accidentbooleanAccident vehicle: the value and the confidence drop; notes states the deduction.
condition.damagebooleanVisible damage: the value drops; notes states the deduction.
includearray["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.

FieldTypeMeaning
value.chfintegerMarket value in Swiss francs, rounded to 100.
value.low · value.highintegerThe range in which most comparable offers lie.
value.basisstringAlways asking_prices: asking prices from listings.
confidence.levelenumhoch (high) from 0.7, mittel (medium) from 0.5, otherwise tief (low). Plus score from 0 to 1.
comparables.countintegerHow many similar listings support the value, at least 3.
comparables.closenessenumeng (close): all near the car. weit (wide): the circle had to be widened.
comparables.levelenumconfiguration: same fuel and transmission. model: the whole model.
marketobjectOnly with include: activeListings listed right now, medianDaysOnline median time online in days.
notesstring[]Notes in German, for example about a deduction for an accident.
attributionobjectText and link that must appear with the value.
dataAsOfstringWhen 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.

Response 404
{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}
Response 422
{
  "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.

Type what you’re looking for: a feature, a question or an error code.

↑ ↓ select↵ openEsc close