API referencaPraćenje vozila

Praćenje vozila

Vozilo koje se procjenjuje svako jutro, s alarmima po vašim pravilima. Vlastitom vozilu (owned) kilometraža raste svaki dan; za traženo (wanted) stižu i povoljni oglasi. Procjenjuje se odmah (1 jedinica); dnevne procjene su besplatne.

POSThttps://api.cifra.ba/v1/watchlist

Pristup: watchlist
Obračun: 1 jedinica po uspješnom pozivu

POST/v1/watchlist

curl -X POST "https://api.cifra.ba/v1/watchlist" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "owned",
    "label": "VW Golf 7 — ugovor 2024/118",
    "external_ref": "2024/118",
    "vehicle": {
      "make": "volkswagen",
      "model": "golf_7",
      "year": 2017,
      "mileage_km": 148000,
      "power_kw": 85,
      "fuel": "diesel",
      "transmission": "manual"
    },
    "km_per_year": 18000,
    "exposure": {
      "kind": "financing",
      "amount_bam": 18500,
      "as_of": "2026-10-18",
      "term_months": 36,
      "annual_rate_pct": 6.9,
      "balloon_bam": 12000
    },
    "alerts": {
      "change_pct": 5,
      "direction": "down",
      "exposure_pct": 85
    },
    "tags": [
      "lizing",
      "sarajevo"
    ]
  }'

Odgovor

{
  "object": "watched_vehicle",
  "id": "wv_3JdP0aZr6YcN2uE5kHq8",
  "kind": "owned",
  "status": "active",
  "label": "VW Golf 7 — ugovor 2024/118",
  "external_ref": "2024/118",
  "tags": [
    "lizing",
    "sarajevo"
  ],
  "note": null,
  "vehicle": {
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "fuel": "diesel",
    "transmission": "manual",
    "make_name": "Volkswagen",
    "model_name": "Golf 7"
  },
  "mileage": {
    "today_km": 148000,
    "given_km": 148000,
    "given_on": "2026-10-18",
    "km_per_year": 18000
  },
  "alerts": {
    "change_pct": 5,
    "direction": "down",
    "below_bam": null,
    "above_bam": null,
    "exposure_pct": 85,
    "deal_pct": null
  },
  "exposure": {
    "kind": "financing",
    "amount_bam": 18500,
    "as_of": "2026-10-18",
    "term_months": 36,
    "annual_rate_pct": 6.9,
    "balloon_bam": 12000,
    "today_bam": 18500,
    "ratio": 0.8277
  },
  "baseline": {
    "value": 22350,
    "on": "2026-10-18"
  },
  "latest": {
    "on": "2026-10-18",
    "point": 22350,
    "low": 18610,
    "high": 26790,
    "confidence_grade": "A",
    "model_version": "car-20261017-1"
  },
  "forecast": {
    "km_per_year": 18000,
    "points": [
      {
        "months": 6,
        "point": 21280,
        "low": 16270,
        "high": 26330
      },
      {
        "months": 12,
        "point": 20270,
        "low": 14540,
        "high": 25760
      },
      {
        "months": 24,
        "point": 18420,
        "low": 13670,
        "high": 23160
      },
      {
        "months": 36,
        "point": 16760,
        "low": 11910,
        "high": 21520
      }
    ]
  },
  "change_since_baseline_pct": 0,
  "created_at": "2026-10-18T22:04:11.532Z",
  "updated_at": "2026-10-18T22:04:11.532Z"
}

Tijelo zahtjeva

application/json

vehicleobjectobavezno
Vozilo, s istim poljima kao tijelo POST /v1/valuations.
Prikaži 24 poljaSakrij polja
- vehicle_typeenumopcionalnopodrazumijevano "car"
  Vrsta vozila. Svaka vrsta ima svoj model, šifarnik i polja koja prima.
  carmotorcycletruck
- makestringobaveznodo 64 znaka
  Marka kao šifra iz GET /v1/taxonomy/makes, npr. volkswagen, mercedes_benz, škoda.
- modelstringobaveznodo 64 znaka
  Model kao šifra iz GET /v1/taxonomy/makes/{make}/models, npr. golf_7.
- yearintegerobaveznonajmanje 1950
  Godište (modelska godina). Najviše sljedeća godina.
- mileage_kmintegerobavezno0 – 2.000.000
  Pređeni kilometri na dan procjene.
- power_kwnumberopcionalno2 – 1000
  Snaga motora u kW. Jedan od najvažnijih podataka za cijenu.
- power_hpnumberopcionalno3 – 1400
  Snaga u KS; koristi se samo kad power_kw nije poslan.
- engine_ccintegeropcionalno40 – 20.000
  Zapremina motora u cm³.
- fuelenumopcionalno
  Gorivo.
  petroldiesellpgcnghybridplugin_hybridelectrichydrogenother
- transmissionenumopcionalno
  Mjenjač.
  manualautomaticsemi_automatic
- drivetrainenumopcionalno
  Pogon. Samo automobili.
  fwdrwdawd
- body_typeenumopcionalno
  Karoserija. Samo automobili.
  sedanhatchbackwagonsuvcoupeconvertibleminivanvanpickupother
- doorsintegeropcionalno2 – 5
  Broj vrata. Samo automobili.
- conditionenumopcionalno
  Stanje: used (podrazumijevano) ili new.
  usednew
- seller_typeenumopcionalno
  Ko prodaje: privatna osoba ili salon.
  privatedealer
- citystringopcionalnodo 80 znakova
  Grad u BiH, npr. Sarajevo ili Banja Luka. Regionalna potražnja pomjera cijenu.
- equipmentstring[]opcionalnodo 150 stavki
  Oprema kako je navodi oglas ili vaš sistem, npr. navigacija, kožna sjedišta.
- owners_countintegeropcionalno1 – 20
  Broj dosadašnjih vlasnika.
- customs_clearedbooleanopcionalno
  Je li vozilo ocarinjeno.
- service_historybooleanopcionalno
  Ima li vozilo servisnu historiju (knjižicu).
- categorystringopcionalnodo 60 znakova
  Motocikli: tip (Naked, Scooter, Enduro…); kamioni: nadogradnja (Kiper, Kombi…). Vrijednosti: GET /v1/taxonomy/values.
- absbooleanopcionalno
  ABS. Samo motocikli.
- axlesintegeropcionalno1 – 6
  Broj osovina. Samo kamioni.
- payload_classstringopcionalnodo 40 znakova
  Nosivost kao razred iz GET /v1/taxonomy/values. Samo kamioni.
kindenumobavezno
owned: vaše vozilo, prati se njegova vrijednost kako stari; wanted: tražena specifikacija, prati se tržišna cijena i povoljni oglasi.
ownedwanted
labelstringopcionalnodo 120 znakova
Naziv koji vidite u izvještajima, npr. broj ugovora.
external_refstringopcionalnodo 120 znakova
Vaša oznaka (ugovor, klijent, vozilo). Po njoj filtrirate listu i izvještaj.
km_per_yearintegeropcionalno0 – 150.000
Vlastita vozila: kilometraža raste ovoliko godišnje, svaki dan. Podrazumijevano: dosadašnji prosjek vozila.
alertsobjectopcionalno
Pravila alarma.
Prikaži 6 poljaSakrij polja
- change_pctnumber | nullopcionalno3 – 90
  Alarm kad se vrijednost pomjeri za ovoliko posto: od početne vrijednosti, zatim od vrijednosti pri zadnjem alarmu. Najmanje 3, jer samo ponovno treniranje modela pomjeri vrijednosti ~2%. null isključuje.
- directionenumopcionalno
  Koji pomak broji za change_pct: any (podrazumijevano), up ili down.
  anyupdown
- below_baminteger | nullopcionalno100 – 5.000.000
  Alarm kad vrijednost padne ispod ove cijene (KM).
- above_baminteger | nullopcionalno100 – 5.000.000
  Alarm kad vrijednost poraste iznad ove cijene (KM).
- exposure_pctnumber | nullopcionalno10 – 300
  Vlastita vozila: alarm na dan kad izloženost (dug, osigurana suma, trošak) dostigne ovaj postotak vrijednosti (LTV), samo pri rastu.
- deal_pctnumber | nullopcionalno5 – 50
  Tražena vozila: alarm za svaki novi oglas iste specifikacije koji traži ovoliko posto manje od Cifrine cijene (najviše 5 dnevno).
exposureobjectopcionalno
Vlastita vozila: iznos vezan za vozilo, za LTV i alarm exposure_pct.
Prikaži 6 poljaSakrij polja
- kindenumobavezno
  financing: stanje kredita ili lizinga (otplaćuje se); insured: osigurana suma; cost: nabavna cijena.
  financinginsuredcost
- amount_bamintegerobavezno100 – 20.000.000
  Iznos u KM na dan as_of.
- as_ofdateopcionalno
  Dan na koji važi amount_bam (podrazumijevano danas).
- term_monthsinteger | nullopcionalno1 – 240
  financing: preostali broj mjeseci; stanje se otplaćuje do balloon_bam, a nakon roka je nula.
- annual_rate_pctnumber | nullopcionalno0 – 40
  financing: nominalna godišnja kamata za anuitetnu otplatu; 0 znači linearnu.
- balloon_baminteger | nullopcionalno0 – 20.000.000
  financing: ostatak na kraju roka (balon rata, otkupna vrijednost).
tagsstring[]opcionalnodo 10 stavki
Vaše grupe, npr. portfelj ili poslovnica (do 10).
notestringopcionalnodo 2000 znakova
Interna napomena.
created_bystringopcionalno8–64 znaka
Samo Cifrine aplikacije; kod vaših ključeva se zanemaruje.

Odgovor

201

objectstringobavezno
watched_vehicle.
idstringobavezno
Oznaka (wv_…).
kindenumobavezno
owned ili wanted.
ownedwanted
statusenumobavezno
active ili paused.
activepaused
labelstringobavezno
Naziv.
external_refstringobavezno
Vaša oznaka.
tagsstring[]obavezno
Vaše grupe.
notestringobavezno
Napomena.
vehicleobjectobavezno
Vozilo kako ste ga poslali, s nazivima iz šifarnika.
Prikaži 5 poljaSakrij polja
- vehicle_typeenumobavezno
  Vrsta vozila.
  carmotorcycletruck
- makestringobavezno
  Šifra marke.
- modelstringobavezno
  Šifra modela.
- make_namestringobavezno
  Naziv marke.
- model_namestringobavezno
  Naziv modela.
mileageobjectobavezno
Kilometraža: vlastitim vozilima raste svaki dan.
Prikaži 4 poljaSakrij polja
- today_kmintegerobavezno
  Procijenjena kilometraža danas.
- given_kmintegerobavezno
  Zadnja kilometraža koju ste poslali.
- given_onstringobavezno
  Kad ste je poslali.
- km_per_yearinteger | nullobavezno
  Godišnji prosjek.
alertsobjectobavezno
Pravila alarma.
Prikaži 6 poljaSakrij polja
- change_pctnumberobavezno
  Prag promjene, %.
- directionenumobavezno
  Smjer.
  anyupdown
- below_baminteger | nullobavezno
  Donja ciljna cijena.
- above_baminteger | nullobavezno
  Gornja ciljna cijena.
- exposure_pctnumberobavezno
  LTV prag, %.
- deal_pctnumberobavezno
  Prag povoljnog oglasa, %.
exposureobject | nullobavezno
Izloženost (samo vlastita vozila).
Prikaži 8 poljaSakrij polja
- kindenumobavezno
  Vrsta izloženosti.
  financinginsuredcost
- amount_bamintegerobavezno
  Iznos na dan as_of.
- as_ofstringobavezno
  Dan na koji važi iznos.
- term_monthsinteger | nullobavezno
  Preostali mjeseci.
- annual_rate_pctnumberobavezno
  Godišnja kamata.
- balloon_baminteger | nullobavezno
  Ostatak na kraju.
- today_bamintegerobavezno
  Iznos danas, nakon otplate.
- rationumberobavezno
  Iznos danas ÷ zadnja vrijednost (LTV), npr. 0.84.
baselineobjectobavezno
Polazna vrijednost.
Prikaži 2 poljaSakrij polja
- valueintegerobavezno
  Vrijednost kad je praćenje počelo.
- onstringobavezno
  Dan.
latestobject | nullobavezno
Zadnja dnevna procjena.
Prikaži 6 poljaSakrij polja
- onstringobavezno
  Dan zadnje procjene.
- pointinteger | nullobavezno
  Vrijednost.
- lowinteger | nullobavezno
  Donja granica.
- highinteger | nullobavezno
  Gornja granica.
- confidence_gradestringobavezno
  Ocjena.
- model_versionstringobavezno
  Verzija modela.
forecastobject | nullobavezno
Prognoza iz zadnje dnevne procjene.
Prikaži 2 poljaSakrij polja
- km_per_yearintegerobavezno
  Pretpostavljena godišnja kilometraža.
- pointsobject[]obavezno
  Vrijednost kroz 6–36 mjeseci.
  Prikaži 4 poljaSakrij polja
  monthsintegerobavezno
  Mjeseci od zadnje procjene.
  pointintegerobavezno
  Vrijednost.
  lowintegerobavezno
  Donja granica.
  highintegerobavezno
  Gornja granica.
change_since_baseline_pctnumberobavezno
Promjena od polazne vrijednosti, %.
created_atstringobavezno
Trenutak u ISO 8601 (UTC).
updated_atstringobavezno
Trenutak u ISO 8601 (UTC).

Greške

400
invalid_request
Tijelo ili parametri ne odgovaraju šemi; errors navodi svako polje.
422
unknown_make
Marka nije u šifarniku (odgovor nosi field).
422
unknown_model
Model nije u šifarniku te marke.
422
vehicle_type_unavailable
Procjene za tu vrstu vozila trenutno nisu dostupne.
409
watchlist_full
Dostignut broj praćenih vozila plana (odgovor nosi max, count).

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

POST/v1/watchlist

curl -X POST "https://api.cifra.ba/v1/watchlist" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "owned",
    "label": "VW Golf 7 — ugovor 2024/118",
    "external_ref": "2024/118",
    "vehicle": {
      "make": "volkswagen",
      "model": "golf_7",
      "year": 2017,
      "mileage_km": 148000,
      "power_kw": 85,
      "fuel": "diesel",
      "transmission": "manual"
    },
    "km_per_year": 18000,
    "exposure": {
      "kind": "financing",
      "amount_bam": 18500,
      "as_of": "2026-10-18",
      "term_months": 36,
      "annual_rate_pct": 6.9,
      "balloon_bam": 12000
    },
    "alerts": {
      "change_pct": 5,
      "direction": "down",
      "exposure_pct": 85
    },
    "tags": [
      "lizing",
      "sarajevo"
    ]
  }'

Odgovor

{
  "object": "watched_vehicle",
  "id": "wv_3JdP0aZr6YcN2uE5kHq8",
  "kind": "owned",
  "status": "active",
  "label": "VW Golf 7 — ugovor 2024/118",
  "external_ref": "2024/118",
  "tags": [
    "lizing",
    "sarajevo"
  ],
  "note": null,
  "vehicle": {
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "fuel": "diesel",
    "transmission": "manual",
    "make_name": "Volkswagen",
    "model_name": "Golf 7"
  },
  "mileage": {
    "today_km": 148000,
    "given_km": 148000,
    "given_on": "2026-10-18",
    "km_per_year": 18000
  },
  "alerts": {
    "change_pct": 5,
    "direction": "down",
    "below_bam": null,
    "above_bam": null,
    "exposure_pct": 85,
    "deal_pct": null
  },
  "exposure": {
    "kind": "financing",
    "amount_bam": 18500,
    "as_of": "2026-10-18",
    "term_months": 36,
    "annual_rate_pct": 6.9,
    "balloon_bam": 12000,
    "today_bam": 18500,
    "ratio": 0.8277
  },
  "baseline": {
    "value": 22350,
    "on": "2026-10-18"
  },
  "latest": {
    "on": "2026-10-18",
    "point": 22350,
    "low": 18610,
    "high": 26790,
    "confidence_grade": "A",
    "model_version": "car-20261017-1"
  },
  "forecast": {
    "km_per_year": 18000,
    "points": [
      {
        "months": 6,
        "point": 21280,
        "low": 16270,
        "high": 26330
      },
      {
        "months": 12,
        "point": 20270,
        "low": 14540,
        "high": 25760
      },
      {
        "months": 24,
        "point": 18420,
        "low": 13670,
        "high": 23160
      },
      {
        "months": 36,
        "point": 16760,
        "low": 11910,
        "high": 21520
      }
    ]
  },
  "change_since_baseline_pct": 0,
  "created_at": "2026-10-18T22:04:11.532Z",
  "updated_at": "2026-10-18T22:04:11.532Z"
}