Docs

API referencaPraćenje vozila

Lista praćenih vozila

Praćena vozila, od najnovijeg, po stranicama (limit, starting_after). Filtrirajte po vašoj oznaci ili statusu.

GEThttps://api.cifra.ba/v1/watchlist
Pristup
watchlist
Obračun
Besplatno
GET/v1/watchlist
curl "https://api.cifra.ba/v1/watchlist?external_ref=2024%2F118" \
  -H "Authorization: Bearer $CIFRA_API_KEY"
Odgovor
{
  "object": "list",
  "data": [
    {
      "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"
    }
  ],
  "has_more": false
}

Parametri upita

  • external_refstringopcionalnodo 120 znakova

    Samo vozila s ovom vašom oznakom.

  • statusenumopcionalno

    Samo aktivna ili samo pauzirana vozila.

    activepaused
  • limitintegeropcionalnopodrazumijevano 501 – 100

    Koliko stavki po stranici.

  • starting_afterstringopcionalno

    Kursor: id zadnje stavke prethodne stranice. Sljedeća stranica počinje iza nje.

Odgovor

200
  • objectstringobavezno

    list.

  • dataobject[]obavezno

    Vozila, od najnovijeg.

    Prikaži 18 polja
    • 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 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 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 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 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 polja
      • valueintegerobavezno

        Vrijednost kad je praćenje počelo.

      • onstringobavezno

        Dan.

    • latestobject | nullobavezno

      Zadnja dnevna procjena.

      Prikaži 6 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 polja
      • km_per_yearintegerobavezno

        Pretpostavljena godišnja kilometraža.

      • pointsobject[]obavezno

        Vrijednost kroz 6–36 mjeseci.

        Prikaži 4 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).

  • has_morebooleanobavezno

    Ima li još stranica (starting_after).

Greške

  • 400
    invalid_request

    Tijelo ili parametri ne odgovaraju šemi; errors navodi svako polje.

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