Docs

API referencaProcjene

Čitanje procjene

Sačuvana procjena s tačnim zahtjevom kojim je nastala, npr. za reviziju odluke. Vidljiva samo ključevima iste kompanije i istog okruženja.

GEThttps://api.cifra.ba/v1/valuations/{id}
Pristup
valuations
Obračun
Besplatno
GET/v1/valuations/{id}
curl "https://api.cifra.ba/v1/valuations/val_yXpheA0qNLw6gYKCq6k1" \
  -H "Authorization: Bearer $CIFRA_API_KEY"
Odgovor
{
  "id": "val_yXpheA0qNLw6gYKCq6k1",
  "object": "valuation",
  "created_at": "2026-10-18T21:57:02.773Z",
  "model_version": "car-20261017-1",
  "valued_by": {
    "kind": "standard",
    "version": "car-20261017-1"
  },
  "vehicle": {
    "vehicle_type": "car",
    "make": "volkswagen",
    "make_name": "Volkswagen",
    "model": "golf_7",
    "model_name": "Golf 7",
    "year": 2017,
    "mileage_km": 148000
  },
  "as_of": "2026-10-18",
  "market_value": {
    "currency": "BAM",
    "point": 22350,
    "low": 18610,
    "high": 26790,
    "confidence_grade": "A",
    "range_probability": 0.8,
    "definition": "Asking price at which a comparable vehicle is listed by a private seller on the valuation date; the range holds the price with 80% probability."
  },
  "explanation": {
    "lines": [
      {
        "id": "base",
        "label": "Bazna vrijednost modela",
        "amount_bam": 22950
      },
      {
        "id": "mileage",
        "label": "Kilometraža",
        "amount_bam": 3270
      },
      {
        "id": "equipment",
        "label": "Oprema i motorizacija",
        "amount_bam": -3090
      },
      {
        "id": "history",
        "label": "Stanje i historija vozila",
        "amount_bam": -20
      },
      {
        "id": "region",
        "label": "Regionalna potražnja",
        "amount_bam": -230
      },
      {
        "id": "market",
        "label": "Stanje tržišta",
        "amount_bam": -530
      }
    ],
    "method": "TreeSHAP contributions of the valuation model, grouped by factor and applied in order."
  },
  "forecast": {
    "status": "beta",
    "km_per_year": 15110,
    "points": [
      {
        "months": 6,
        "point": 21380,
        "low": 16350,
        "high": 26450
      },
      {
        "months": 12,
        "point": 20450,
        "low": 14670,
        "high": 25990
      },
      {
        "months": 24,
        "point": 18710,
        "low": 13890,
        "high": 23530
      },
      {
        "months": 36,
        "point": 17150,
        "low": 12190,
        "high": 22020
      }
    ],
    "method": "Learned depreciation curve for this age and brand tier; market level held at today's."
  },
  "sale_price": {
    "status": "unavailable",
    "detail": "Needs transaction data; planned as an experimental output."
  },
  "time_to_sell": {
    "status": "unavailable",
    "detail": "Needs a few months of market exit data; planned."
  },
  "warnings": [],
  "comparables_total": 502,
  "request": {
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "engine_cc": 1598,
    "fuel": "diesel",
    "transmission": "manual",
    "body_type": "hatchback",
    "city": "Sarajevo",
    "include": [
      "explanation",
      "forecast",
      "comparables"
    ]
  }
}

Parametri putanje

  • idstringobavezno

    Oznaka procjene (val_…).

Odgovor

200
  • idstringobavezno

    Oznaka procjene (val_…); po njoj je čitate i javljate prodajnu cijenu.

  • objectstringobavezno

    Uvijek valuation.

  • created_atstringobavezno

    Trenutak u ISO 8601 (UTC).

  • model_versionstringobavezno

    Verzija modela koji je procijenio, npr. car-20261017-1.

  • valued_byobjectobavezno

    Koji model je odgovorio.

    Prikaži 7 polja
    • kindenumobavezno

      standard: Cifrin tržišni model; custom: model vaše kompanije.

      standardcustom
    • versionstringobavezno

      Verzija modela koji je odgovorio, npr. car-20261017-1.

    • custom_model_idintegeropcionalno

      Model kompanije: njegov broj.

    • namestringopcionalno

      Model kompanije: naziv koji ste mu dali.

    • price_kindenumopcionalno

      Model kompanije: koje cijene je učio, pa šta vrijednost znači — prodajne, nabavne, oglasne ili procjene.

      salepurchaseaskingappraisal
    • base_versionstringopcionalno

      Model kompanije: standardni model na kojem je napravljen.

    • fallbackstringopcionalno

      Vaš model trenutno nije mogao odgovoriti, pa je odgovorio standardni.

  • sandboxbooleanopcionalno

    Samo testni ključevi: fiksne primjer-vrijednosti.

  • vehicleobjectobavezno

    Procijenjeno vozilo, s nazivima iz šifarnika.

    Prikaži 7 polja
    • vehicle_typeenumobavezno

      Vrsta vozila.

      carmotorcycletruck
    • makestringobavezno

      Šifra marke.

    • make_namestringobavezno

      Naziv marke, npr. Volkswagen.

    • modelstringobavezno

      Šifra modela.

    • model_namestringobavezno

      Naziv modela, npr. Golf 7.

    • yearintegerobavezno

      Godište.

    • mileage_kmintegerobavezno

      Kilometraža.

  • as_ofstringobavezno

    Dan na koji važi vrijednost.

  • market_valueobjectobavezno

    Tržišna vrijednost s rasponom od 80% i ocjenom pouzdanosti.

    Prikaži 7 polja
    • currencystringobavezno

      Uvijek BAM (konvertibilna marka).

    • pointintegerobavezno

      Tržišna vrijednost, zaokružena na 10 KM.

    • lowintegerobavezno

      Donja granica raspona.

    • highintegerobavezno

      Gornja granica raspona.

    • confidence_gradeenumobavezno

      Ocjena pouzdanosti: A najuži rasponi za takva vozila, C najširi (rijetki modeli, malo podataka, nepotpun unos).

      ABC
    • range_probabilitynumberobavezno

      Vjerovatnoća da je cijena u rasponu: 0.8 (80%).

    • definitionstringobavezno

      Šta tačno vrijednost znači, jednom rečenicom.

  • standard_valueobjectopcionalno

    Samo uz model kompanije: šta kaže standardni tržišni model, za poređenje.

    Prikaži 6 polja
    • currencystringobavezno

      BAM.

    • pointintegerobavezno

      Vrijednost po standardnom modelu.

    • lowintegerobavezno

      Donja granica.

    • highintegerobavezno

      Gornja granica.

    • confidence_gradeenumobavezno

      Ocjena pouzdanosti: A najuži rasponi za takva vozila, C najširi (rijetki modeli, malo podataka, nepotpun unos).

      ABC
    • model_versionstringobavezno

      Verzija standardnog modela.

  • explanationobjectopcionalno

    Obračun cijene po faktorima (uz include: ["explanation"]).

    Prikaži 2 polja
    • linesobject[]obavezno

      Linije koje se tačno sabiraju u market_value.point.

      Prikaži 3 polja
      • idenumobavezno

        Faktor: base (bazna vrijednost modela), mileage, equipment (oprema i motorizacija), history (stanje i historija), region, market, adjustment (korekcija tržišnog tima).

        basemileageequipmenthistoryregionmarketadjustment
      • labelstringobavezno

        Naziv faktora na bosanskom, za prikaz korisniku.

      • amount_bamintegerobavezno

        Prva linija: bazna vrijednost; ostale: koliko faktor dodaje ili oduzima.

    • methodstringobavezno

      Kako je obračun nastao.

  • forecastobjectopcionalno

    Prognoza vrijednosti (uz include: ["forecast"]): naučena kriva gubitka vrijednosti, uz današnji nivo tržišta.

    Prikaži 4 polja
    • statusstringobavezno

      beta.

    • km_per_yearintegerobavezno

      Godišnja kilometraža pretpostavljena u prognozi.

    • pointsobject[]obavezno

      Vrijednost kroz vrijeme, s rasponom koji se širi.

      Prikaži 4 polja
      • monthsintegerobavezno

        Mjeseci od as_of: 6, 12, 24, 36.

      • pointintegerobavezno

        Očekivana vrijednost.

      • lowintegerobavezno

        Donja granica.

      • highintegerobavezno

        Gornja granica.

    • methodstringobavezno

      Kako je prognoza nastala.

  • sale_priceobjectobavezno

    Procjena stvarne prodajne cijene: u pripremi.

    Prikaži 2 polja
    • statusstringobavezno

      Još nije dostupno.

    • detailstringobavezno

      Zašto.

  • time_to_sellobjectobavezno

    Očekivano vrijeme do prodaje: u pripremi.

    Prikaži 2 polja
    • statusstringobavezno

      Još nije dostupno.

    • detailstringobavezno

      Zašto.

  • adjustmentobjectopcionalno

    Kad Cifrin tržišni tim privremeno koriguje model za neki segment (najviše ±15%, do 180 dana).

    Prikaži 2 polja
    • multipliernumberobavezno

      Faktor korekcije, npr. 0.97.

    • reasonstringobavezno

      Razlog korekcije.

  • warningsobject[]obavezno

    Upozorenja uz procjenu. Prazna lista znači da nema ničeg posebnog.

    Prikaži 2 polja
    • codestringobavezno

      Stabilna šifra upozorenja, npr. partial_inputs.

    • messagestringobavezno

      Objašnjenje na engleskom, za logove i podršku.

  • comparables_totalintegeropcionalno

    Ako su tražena slična vozila: koliko ih je tad bilo u prodaji.

  • requestobjectobavezno

    Tijelo zahtjeva kojim je procjena napravljena.

Greške

  • 404
    not_found

    Ne postoji, ili pripada drugoj kompaniji ili drugom okruženju.

Uz ove, svaki poziv s ključem može vratiti opšte greške (ključ, pristup, limiti).