API referencaPraćenje vozila

Dnevni izvještaj

Svako praćeno vozilo na jedan dan: vrijednost, promjena od prethodne i od polazne, izloženost i LTV, i alarmi tog dana. Spreman svako jutro; javlja ga webhook watchlist.report_ready.

GEThttps://api.cifra.ba/v1/watchlist/report

Pristup: watchlist
Obračun: Besplatno

GET/v1/watchlist/report

curl "https://api.cifra.ba/v1/watchlist/report?day=2026-12-02" \
  -H "Authorization: Bearer $CIFRA_API_KEY"

Odgovor

{
  "object": "watchlist_report",
  "day": "2026-12-02",
  "summary": {
    "vehicles": 412,
    "valued": 412,
    "up": 37,
    "down": 351,
    "alerts": 1
  },
  "data": [
    {
      "id": "wv_3JdP0aZr6YcN2uE5kHq8",
      "label": "VW Golf 7 — ugovor 2024/118",
      "external_ref": "2024/118",
      "kind": "owned",
      "status": "active",
      "tags": [
        "lizing",
        "sarajevo"
      ],
      "value": {
        "point": 21400,
        "low": 17820,
        "high": 25650,
        "confidence_grade": "A"
      },
      "previous": {
        "day": "2026-12-01",
        "point": 21560
      },
      "change_pct": -0.74,
      "change_since_baseline_pct": -4.25,
      "exposure": {
        "amount_bam": 18259,
        "ratio": 0.8532
      },
      "alerts": [
        {
          "object": "alert",
          "id": "alr_8fK2mQ9xLp4TvB7nR1sW",
          "type": "exposure_above",
          "watched_vehicle": {
            "id": "wv_3JdP0aZr6YcN2uE5kHq8",
            "label": "VW Golf 7 — ugovor 2024/118",
            "external_ref": "2024/118",
            "kind": "owned"
          },
          "day": "2026-12-02",
          "previous_value": 22350,
          "value": 21400,
          "change_pct": -4.25,
          "threshold": 85,
          "details": {
            "exposure": {
              "kind": "financing",
              "amount": 18259,
              "ratio": 0.8532
            }
          },
          "created_at": "2026-12-02T06:12:44.000Z"
        }
      ]
    }
  ]
}

Parametri upita

daydateopcionalno
Dan izvještaja (YYYY-MM-DD); podrazumijevano zadnji procijenjeni dan.
external_refstringopcionalnodo 120 znakova
Samo vozila s ovom vašom oznakom.

Odgovor

200

objectstringobavezno
watchlist_report.
daystringobavezno
Dan izvještaja.
summaryobjectobavezno
Sažetak dana.
Prikaži 5 poljaSakrij polja
- vehiclesintegerobavezno
  Vozila u izvještaju.
- valuedintegerobavezno
  Procijenjena tog dana.
- upintegerobavezno
  Porasla.
- downintegerobavezno
  Pala.
- alertsintegerobavezno
  Alarmi tog dana.
dataobject[]obavezno
Svako vozilo.
Prikaži 12 poljaSakrij polja
- idstringobavezno
  Vozilo.
- labelstringobavezno
  Naziv.
- external_refstringobavezno
  Vaša oznaka.
- kindenumobavezno
  Vrsta.
  ownedwanted
- statusenumobavezno
  Status.
  activepaused
- tagsstring[]obavezno
  Grupe.
- valueobject | nullobavezno
  Vrijednost tog dana; null ako nije procijenjeno.
  Prikaži 4 poljaSakrij polja
  pointintegerobavezno
  Vrijednost.
  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
- previousobject | nullobavezno
  Prethodna procjena.
  Prikaži 2 poljaSakrij polja
  daystringobavezno
  Dan, YYYY-MM-DD.
  pointintegerobavezno
  Vrijednost.
- change_pctnumberobavezno
  Promjena od prethodne, %.
- change_since_baseline_pctnumberobavezno
  Promjena od polazne, %.
- exposureobject | nullobavezno
  Izloženost i LTV tog dana.
  Prikaži 2 poljaSakrij polja
  amount_bamintegerobavezno
  Izloženost tog dana.
  rationumberobavezno
  LTV.
- alertsobject[]obavezno
  Alarmi tog dana.
  Prikaži 11 poljaSakrij polja
  objectstringobavezno
  alert.
  idstringobavezno
  Oznaka (alr_…).
  typeenumobavezno
  value_changed (change_pct), below_target / above_target (below_bam / above_bam), exposure_above (exposure_pct), market_deal (deal_pct).
  value_changedbelow_targetabove_targetexposure_abovemarket_deal
  watched_vehicleobjectobavezno
  Vozilo na koje se alarm odnosi.
  Prikaži 4 poljaSakrij polja
  idstringobavezno
  Vozilo.
  labelstringobavezno
  Naziv.
  external_refstringobavezno
  Vaša oznaka.
  kindenumobavezno
  Vrsta.
  ownedwanted
  daystringobavezno
  Dan procjene koji je pokrenuo alarm.
  previous_valueintegerobavezno
  Vrijednost od koje se mjeri (za market_deal: Cifrina cijena oglasa).
  valueintegerobavezno
  Nova vrijednost (za market_deal: cijena u oglasu).
  change_pctnumberobavezno
  Promjena, %.
  thresholdnumberobavezno
  Prag pravila koje se aktiviralo.
  detailsobject | nullobavezno
  Pojedinosti, zavisno od vrste.
  Prikaži 3 poljaSakrij polja
  exposureobjectopcionalno
  exposure_above: izloženost tog dana.
  Prikaži 3 poljaSakrij polja
  kindstringobavezno
  Vrsta izloženosti.
  amountintegerobavezno
  Iznos tog dana.
  rationumberobavezno
  LTV tog dana.
  listingobjectopcionalno
  market_deal: oglas.
  Prikaži 9 poljaSakrij polja
  idintegerobavezno
  Oznaka oglasa kod Cifre.
  titlestringobavezno
  Naslov.
  yearintegerobavezno
  Godište.
  kminteger | nullobavezno
  Kilometraža.
  priceintegerobavezno
  Cijena.
  fairPriceintegerobavezno
  Cifrina cijena.
  placestringobavezno
  Mjesto.
  urlstringobavezno
  Link oglasa.
  sellerstringobavezno
  Vrsta prodavca.
  modelChangedobjectopcionalno
  Tog dana je počeo raditi novi model: dio pomaka može biti model, ne tržište.
  Prikaži 2 poljaSakrij polja
  fromstringobavezno
  Prethodni model.
  tostringobavezno
  Novi model.
  created_atstringobavezno
  Trenutak u ISO 8601 (UTC).

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).

GET/v1/watchlist/report

curl "https://api.cifra.ba/v1/watchlist/report?day=2026-12-02" \
  -H "Authorization: Bearer $CIFRA_API_KEY"

Odgovor

{
  "object": "watchlist_report",
  "day": "2026-12-02",
  "summary": {
    "vehicles": 412,
    "valued": 412,
    "up": 37,
    "down": 351,
    "alerts": 1
  },
  "data": [
    {
      "id": "wv_3JdP0aZr6YcN2uE5kHq8",
      "label": "VW Golf 7 — ugovor 2024/118",
      "external_ref": "2024/118",
      "kind": "owned",
      "status": "active",
      "tags": [
        "lizing",
        "sarajevo"
      ],
      "value": {
        "point": 21400,
        "low": 17820,
        "high": 25650,
        "confidence_grade": "A"
      },
      "previous": {
        "day": "2026-12-01",
        "point": 21560
      },
      "change_pct": -0.74,
      "change_since_baseline_pct": -4.25,
      "exposure": {
        "amount_bam": 18259,
        "ratio": 0.8532
      },
      "alerts": [
        {
          "object": "alert",
          "id": "alr_8fK2mQ9xLp4TvB7nR1sW",
          "type": "exposure_above",
          "watched_vehicle": {
            "id": "wv_3JdP0aZr6YcN2uE5kHq8",
            "label": "VW Golf 7 — ugovor 2024/118",
            "external_ref": "2024/118",
            "kind": "owned"
          },
          "day": "2026-12-02",
          "previous_value": 22350,
          "value": 21400,
          "change_pct": -4.25,
          "threshold": 85,
          "details": {
            "exposure": {
              "kind": "financing",
              "amount": 18259,
              "ratio": 0.8532
            }
          },
          "created_at": "2026-12-02T06:12:44.000Z"
        }
      ]
    }
  ]
}