Docs

API referencaAlarmi

Lista alarma

Alarmi svih praćenih vozila, od najnovijeg, po stranicama. Isti alarmi stižu i webhookom watchlist.alert; lista služi za pregled i za nadoknadu propuštenog.

GEThttps://api.cifra.ba/v1/alerts
Pristup
watchlist
Obračun
Besplatno
GET/v1/alerts
curl "https://api.cifra.ba/v1/alerts?since=2026-10-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer $CIFRA_API_KEY"
Odgovor
{
  "object": "list",
  "data": [
    {
      "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"
    },
    {
      "object": "alert",
      "id": "alr_Vb3nQ7xR2kLp9TzW5mYc",
      "type": "market_deal",
      "watched_vehicle": {
        "id": "wv_9QeL2mXc7TbN4vR8kPz1",
        "label": "Traži: Octavia 2018+",
        "external_ref": null,
        "kind": "wanted"
      },
      "day": "2026-10-20",
      "previous_value": 24900,
      "value": 21500,
      "change_pct": -13.65,
      "threshold": 12,
      "details": {
        "listing": {
          "id": 9812334,
          "title": "Škoda Octavia 2.0 TDI Style",
          "year": 2018,
          "km": 168000,
          "price": 21500,
          "fairPrice": 24900,
          "place": "Mostar",
          "url": "https://olx.ba/artikal/61234567",
          "seller": "PRIVATE"
        }
      },
      "created_at": "2026-10-20T06:09:31.000Z"
    }
  ],
  "has_more": false
}

Parametri upita

  • watched_vehicle_idstringopcionalno

    Samo alarmi jednog praćenog vozila (wv_…).

  • sincedatetimeopcionalno

    Samo alarmi nastali od ovog trenutka (ISO 8601).

  • 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

    Alarmi, od najnovijeg.

    Prikaži 11 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 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 polja
      • exposureobjectopcionalno

        exposure_above: izloženost tog dana.

        Prikaži 3 polja
        • kindstringobavezno

          Vrsta izloženosti.

        • amountintegerobavezno

          Iznos tog dana.

        • rationumberobavezno

          LTV tog dana.

      • listingobjectopcionalno

        market_deal: oglas.

        Prikaži 9 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 polja
        • fromstringobavezno

          Prethodni model.

        • tostringobavezno

          Novi model.

    • created_atstringobavezno

      Trenutak u ISO 8601 (UTC).

  • has_morebooleanobavezno

    Ima li još stranica.

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