{"openapi":"3.1.0","info":{"title":"Cifra API","version":"1.0.0","description":"Market values for vehicles in Bosnia and Herzegovina, with calibrated ranges, explanations and forecasts; vehicle listing history and risk signals; a watchlist revalued daily with alerts and webhooks. Authenticate with `Authorization: Bearer cfr_live_…` (sandbox: `cfr_test_…`, fixed example values, not billable). Responses carry `x-request-id`, `x-ratelimit-*` and, on metered plans, `x-quota-remaining`. Errors are `application/problem+json` with a stable `code`. Docs: https://www.cifra.ba/docs","contact":{"name":"Cifra","email":"podrska@cifra.ba","url":"https://www.cifra.ba/docs"}},"servers":[{"url":"https://api.cifra.ba"}],"tags":[{"name":"Valuations"},{"name":"Taxonomy"},{"name":"Vehicle history"},{"name":"Watchlist"},{"name":"Alerts"},{"name":"Webhooks"},{"name":"Widgets"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"code":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"},"code":{"type":"string"}},"required":["path","message","code"],"additionalProperties":false}},"field":{"type":"string"}},"required":["type","title","status","code","detail","request_id"],"additionalProperties":{}},"Valuation":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"valuation"},"created_at":{"type":"string"},"model_version":{"type":"string"},"valued_by":{"type":"object","properties":{"kind":{"type":"string","enum":["standard","custom"]},"version":{"type":"string"},"custom_model_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"},"price_kind":{"type":"string","enum":["sale","purchase","asking","appraisal"]},"base_version":{"type":"string"},"fallback":{"type":"string","const":"custom_model_unavailable"}},"required":["kind","version"],"additionalProperties":false},"sandbox":{"type":"boolean","const":true},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"make_name":{"type":"string"},"model":{"type":"string"},"model_name":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["vehicle_type","make","make_name","model","model_name","year","mileage_km"],"additionalProperties":false},"as_of":{"type":"string"},"market_value":{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]},"range_probability":{"type":"number"},"definition":{"type":"string"}},"required":["currency","point","low","high","confidence_grade","range_probability","definition"],"additionalProperties":false},"standard_value":{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]},"model_version":{"type":"string"}},"required":["currency","point","low","high","confidence_grade","model_version"],"additionalProperties":false},"explanation":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["base","mileage","equipment","history","region","market","adjustment"]},"label":{"type":"string"},"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","label","amount_bam"],"additionalProperties":false}},"method":{"type":"string"}},"required":["lines","method"],"additionalProperties":false},"forecast":{"type":"object","properties":{"status":{"type":"string","const":"beta"},"km_per_year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["months","point","low","high"],"additionalProperties":false}},"method":{"type":"string"}},"required":["status","km_per_year","points","method"],"additionalProperties":false},"sale_price":{"type":"object","properties":{"status":{"type":"string","const":"unavailable"},"detail":{"type":"string"}},"required":["status","detail"],"additionalProperties":false},"time_to_sell":{"type":"object","properties":{"status":{"type":"string","const":"unavailable"},"detail":{"type":"string"}},"required":["status","detail"],"additionalProperties":false},"adjustment":{"type":"object","properties":{"multiplier":{"type":"number"},"reason":{"type":"string"}},"required":["multiplier","reason"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"comparables":{"type":"object","properties":{"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fuel":{"type":["string","null"]},"transmission":{"type":["string","null"]},"power_kw":{"type":["number","null"]},"engine_cc":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"city":{"type":["string","null"]},"asking_price_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cifra_value_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"price_vs_value_pct":{"type":"number"},"days_listed":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["year","mileage_km","fuel","transmission","power_kw","engine_cc","city","asking_price_bam","cifra_value_bam","price_vs_value_pct","days_listed"],"additionalProperties":false}}},"required":["total","items"],"additionalProperties":false}},"required":["id","object","created_at","model_version","valued_by","vehicle","as_of","market_value","sale_price","time_to_sell","warnings"],"additionalProperties":false},"ValuationRequest":{"type":"object","properties":{"vehicle_type":{"default":"car","type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\p{Ll}\\p{Nd}_]+$","description":"Make slug from /v1/taxonomy/makes, e.g. volkswagen"},"model":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\p{Ll}\\p{Nd}_]+$","description":"Model slug from /v1/taxonomy/makes/{make}/models, e.g. golf_7"},"year":{"type":"integer","minimum":1950,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":0,"maximum":2000000},"power_kw":{"type":"number","minimum":2,"maximum":1000},"power_hp":{"description":"Used only when power_kw is absent","type":"number","minimum":3,"maximum":1400},"engine_cc":{"type":"integer","minimum":40,"maximum":20000},"fuel":{"type":"string","enum":["petrol","diesel","lpg","cng","hybrid","plugin_hybrid","electric","hydrogen","other"]},"transmission":{"type":"string","enum":["manual","automatic","semi_automatic"]},"drivetrain":{"type":"string","enum":["fwd","rwd","awd"]},"body_type":{"type":"string","enum":["sedan","hatchback","wagon","suv","coupe","convertible","minivan","van","pickup","other"]},"doors":{"type":"integer","minimum":2,"maximum":5},"condition":{"description":"Defaults to used","type":"string","enum":["used","new"]},"seller_type":{"type":"string","enum":["private","dealer"]},"city":{"type":"string","minLength":1,"maxLength":80},"equipment":{"maxItems":150,"type":"array","items":{"type":"string","minLength":1,"maxLength":50}},"owners_count":{"type":"integer","minimum":1,"maximum":20},"customs_cleared":{"type":"boolean"},"service_history":{"type":"boolean"},"category":{"description":"Motorcycles: type (Naked, Scooter, Enduro…); trucks: body (Kiper, Kombi…). See /v1/taxonomy/values","type":"string","minLength":1,"maxLength":60},"abs":{"description":"Motorcycles","type":"boolean"},"axles":{"description":"Trucks","type":"integer","minimum":1,"maximum":6},"payload_class":{"description":"Trucks: payload band, see /v1/taxonomy/values","type":"string","minLength":1,"maxLength":40},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"include":{"description":"Default: explanation and forecast","maxItems":3,"type":"array","items":{"type":"string","enum":["explanation","forecast","comparables"]}},"km_per_year":{"type":"integer","minimum":0,"maximum":150000},"valuation_model":{"description":"auto (default): your company's own model when one is in service, else the standard model; standard: always the standard model","type":"string","enum":["auto","standard"]}},"required":["make","model","year","mileage_km"],"additionalProperties":false},"BatchResult":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"valuation":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"valuation"},"created_at":{"type":"string"},"model_version":{"type":"string"},"valued_by":{"type":"object","properties":{"kind":{"type":"string","enum":["standard","custom"]},"version":{"type":"string"},"custom_model_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"},"price_kind":{"type":"string","enum":["sale","purchase","asking","appraisal"]},"base_version":{"type":"string"},"fallback":{"type":"string","const":"custom_model_unavailable"}},"required":["kind","version"],"additionalProperties":false},"sandbox":{"type":"boolean","const":true},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"make_name":{"type":"string"},"model":{"type":"string"},"model_name":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["vehicle_type","make","make_name","model","model_name","year","mileage_km"],"additionalProperties":false},"as_of":{"type":"string"},"market_value":{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]},"range_probability":{"type":"number"},"definition":{"type":"string"}},"required":["currency","point","low","high","confidence_grade","range_probability","definition"],"additionalProperties":false},"standard_value":{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]},"model_version":{"type":"string"}},"required":["currency","point","low","high","confidence_grade","model_version"],"additionalProperties":false},"explanation":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["base","mileage","equipment","history","region","market","adjustment"]},"label":{"type":"string"},"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","label","amount_bam"],"additionalProperties":false}},"method":{"type":"string"}},"required":["lines","method"],"additionalProperties":false},"forecast":{"type":"object","properties":{"status":{"type":"string","const":"beta"},"km_per_year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["months","point","low","high"],"additionalProperties":false}},"method":{"type":"string"}},"required":["status","km_per_year","points","method"],"additionalProperties":false},"sale_price":{"type":"object","properties":{"status":{"type":"string","const":"unavailable"},"detail":{"type":"string"}},"required":["status","detail"],"additionalProperties":false},"time_to_sell":{"type":"object","properties":{"status":{"type":"string","const":"unavailable"},"detail":{"type":"string"}},"required":["status","detail"],"additionalProperties":false},"adjustment":{"type":"object","properties":{"multiplier":{"type":"number"},"reason":{"type":"string"}},"required":["multiplier","reason"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"comparables":{"type":"object","properties":{"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fuel":{"type":["string","null"]},"transmission":{"type":["string","null"]},"power_kw":{"type":["number","null"]},"engine_cc":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"city":{"type":["string","null"]},"asking_price_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cifra_value_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"price_vs_value_pct":{"type":"number"},"days_listed":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["year","mileage_km","fuel","transmission","power_kw","engine_cc","city","asking_price_bam","cifra_value_bam","price_vs_value_pct","days_listed"],"additionalProperties":false}}},"required":["total","items"],"additionalProperties":false}},"required":["id","object","created_at","model_version","valued_by","vehicle","as_of","market_value","sale_price","time_to_sell","warnings"],"additionalProperties":false},"error":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["code"],"additionalProperties":false}},"required":["index"],"additionalProperties":false}},"valued":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["object","data","valued","failed"],"additionalProperties":false},"BatchRequest":{"type":"object","properties":{"items":{"minItems":1,"maxItems":1000,"type":"array","items":{}},"include":{"maxItems":3,"type":"array","items":{"type":"string","enum":["explanation","forecast","comparables"]}}},"required":["items"],"additionalProperties":false},"StoredValuation":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"valuation"},"created_at":{"type":"string"},"model_version":{"type":"string"},"valued_by":{"type":"object","properties":{"kind":{"type":"string","enum":["standard","custom"]},"version":{"type":"string"},"custom_model_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"},"price_kind":{"type":"string","enum":["sale","purchase","asking","appraisal"]},"base_version":{"type":"string"},"fallback":{"type":"string","const":"custom_model_unavailable"}},"required":["kind","version"],"additionalProperties":false},"sandbox":{"type":"boolean","const":true},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"make_name":{"type":"string"},"model":{"type":"string"},"model_name":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["vehicle_type","make","make_name","model","model_name","year","mileage_km"],"additionalProperties":false},"as_of":{"type":"string"},"market_value":{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]},"range_probability":{"type":"number"},"definition":{"type":"string"}},"required":["currency","point","low","high","confidence_grade","range_probability","definition"],"additionalProperties":false},"standard_value":{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]},"model_version":{"type":"string"}},"required":["currency","point","low","high","confidence_grade","model_version"],"additionalProperties":false},"explanation":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["base","mileage","equipment","history","region","market","adjustment"]},"label":{"type":"string"},"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","label","amount_bam"],"additionalProperties":false}},"method":{"type":"string"}},"required":["lines","method"],"additionalProperties":false},"forecast":{"type":"object","properties":{"status":{"type":"string","const":"beta"},"km_per_year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["months","point","low","high"],"additionalProperties":false}},"method":{"type":"string"}},"required":["status","km_per_year","points","method"],"additionalProperties":false},"sale_price":{"type":"object","properties":{"status":{"type":"string","const":"unavailable"},"detail":{"type":"string"}},"required":["status","detail"],"additionalProperties":false},"time_to_sell":{"type":"object","properties":{"status":{"type":"string","const":"unavailable"},"detail":{"type":"string"}},"required":["status","detail"],"additionalProperties":false},"adjustment":{"type":"object","properties":{"multiplier":{"type":"number"},"reason":{"type":"string"}},"required":["multiplier","reason"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"comparables_total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"request":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","object","created_at","model_version","valued_by","vehicle","as_of","market_value","sale_price","time_to_sell","warnings","request"],"additionalProperties":false},"OutcomeResult":{"type":"object","properties":{"object":{"type":"string","const":"valuation_outcome"},"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"valuation_id":{"type":"string"},"sold_price_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"created_at":{"type":"string"}},"required":["object","id","valuation_id","sold_price_bam","created_at"],"additionalProperties":false},"Outcome":{"type":"object","properties":{"sold_price_bam":{"type":"integer","minimum":100,"maximum":5000000},"sold_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["sold_price_bam"],"additionalProperties":false},"Makes":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"models":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["slug","name","models"],"additionalProperties":false}}},"required":["object","data"],"additionalProperties":false},"Models":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false}}},"required":["object","data"],"additionalProperties":false},"Values":{"type":"object","properties":{"fuel":{"type":"array","items":{"type":"string"}},"transmission":{"type":"array","items":{"type":"string"}},"drivetrain":{"type":"array","items":{"type":"string"}},"body_type":{"type":"array","items":{"type":"string"}},"category":{"type":"array","items":{"type":"string"}},"payload_class":{"type":"array","items":{"type":"string"}},"condition":{"type":"array","items":{"type":"string"}},"seller_type":{"type":"array","items":{"type":"string"}}},"required":["fuel","condition","seller_type"],"additionalProperties":false},"VehicleHistory":{"type":"object","properties":{"object":{"type":"string","const":"vehicle_history"},"query":{"type":"object","properties":{"source":{"type":"string"},"listing_id":{"type":"string"}},"required":["source","listing_id"],"additionalProperties":false},"vehicle":{"type":"object","properties":{"make":{"type":["string","null"]},"model":{"type":["string","null"]},"year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"fuel":{"type":["string","null"]},"power_kw":{"type":["number","null"]}},"required":["make","model","year","fuel","power_kw"],"additionalProperties":false},"identity":{"anyOf":[{"type":"object","properties":{"listings":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sites":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_seen_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_seen_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"mileage_range_km":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"confidence":{"type":"number"}},"required":["listings","sites","first_seen_on","last_seen_on","mileage_range_km","confidence"],"additionalProperties":false},{"type":"null"}]},"listings":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"is_query":{"type":"boolean"},"status":{"type":"string","enum":["active","sold","gone"]},"listed_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_seen_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"days_listed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"first_price_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_price_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"city":{"type":["string","null"]},"link":{"anyOf":[{"type":"object","properties":{"confidence":{"type":"number"},"matched_on":{"type":"array","items":{"type":"string"}},"mileage_change_km":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"days_after_previous":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["confidence","matched_on","mileage_change_km","days_after_previous"],"additionalProperties":false},{"type":"null"}]}},"required":["source","is_query","status","listed_on","last_seen_on","days_listed","mileage_km","first_price_bam","last_price_bam","city","link"],"additionalProperties":false}},"level":{"type":"string","enum":["high","elevated","low"]},"signals":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["high","medium","info"]},"summary":{"type":"string"},"message":{"type":"string"},"check":{"type":["string","null"]}},"required":["code","severity","summary","message","check"],"additionalProperties":false}},"in_favour":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"summary":{"type":"string"}},"required":["code","summary"],"additionalProperties":false}},"market":{"anyOf":[{"type":"object","properties":{"asking_price_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"cifra_price_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"vs_market":{"type":["number","null"]},"mileage_percentile_for_age":{"type":["number","null"]}},"required":["asking_price_bam","cifra_price_bam","vs_market","mileage_percentile_for_age"],"additionalProperties":false},{"type":"null"}]},"note":{"type":"string"}},"required":["object","query","vehicle","identity","listings","level","signals","in_favour","market","note"],"additionalProperties":false},"WatchedVehicle":{"type":"object","properties":{"object":{"type":"string","const":"watched_vehicle"},"id":{"type":"string"},"kind":{"type":"string","enum":["owned","wanted"]},"status":{"type":"string","enum":["active","paused"]},"label":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"note":{"type":["string","null"]},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"model":{"type":"string"},"make_name":{"type":["string","null"]},"model_name":{"type":["string","null"]}},"required":["vehicle_type","make","model","make_name","model_name"],"additionalProperties":{}},"mileage":{"type":"object","properties":{"today_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"given_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"given_on":{"type":"string"},"km_per_year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["today_km","given_km","given_on","km_per_year"],"additionalProperties":false},"alerts":{"type":"object","properties":{"change_pct":{"type":["number","null"]},"direction":{"type":"string","enum":["any","up","down"]},"below_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"above_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"exposure_pct":{"type":["number","null"]},"deal_pct":{"type":["number","null"]}},"required":["change_pct","direction","below_bam","above_bam","exposure_pct","deal_pct"],"additionalProperties":false},"exposure":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["financing","insured","cost"]},"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of":{"type":"string"},"term_months":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"annual_rate_pct":{"type":["number","null"]},"balloon_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"today_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ratio":{"type":["number","null"]}},"required":["kind","amount_bam","as_of","term_months","annual_rate_pct","balloon_bam","today_bam","ratio"],"additionalProperties":false},{"type":"null"}]},"baseline":{"type":"object","properties":{"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"on":{"type":"string"}},"required":["value","on"],"additionalProperties":false},"latest":{"anyOf":[{"type":"object","properties":{"on":{"type":"string"},"point":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"low":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"high":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence_grade":{"type":["string","null"]},"model_version":{"type":["string","null"]}},"required":["on","point","low","high","confidence_grade","model_version"],"additionalProperties":false},{"type":"null"}]},"forecast":{"anyOf":[{"type":"object","properties":{"km_per_year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["months","point","low","high"],"additionalProperties":false}}},"required":["km_per_year","points"],"additionalProperties":false},{"type":"null"}]},"change_since_baseline_pct":{"type":["number","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["object","id","kind","status","label","external_ref","tags","note","vehicle","mileage","alerts","exposure","baseline","latest","forecast","change_since_baseline_pct","created_at","updated_at"],"additionalProperties":false},"WatchCreate":{"type":"object","properties":{"vehicle":{"type":"object","properties":{"vehicle_type":{"default":"car","type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\p{Ll}\\p{Nd}_]+$","description":"Make slug from /v1/taxonomy/makes, e.g. volkswagen"},"model":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\p{Ll}\\p{Nd}_]+$","description":"Model slug from /v1/taxonomy/makes/{make}/models, e.g. golf_7"},"year":{"type":"integer","minimum":1950,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":0,"maximum":2000000},"power_kw":{"type":"number","minimum":2,"maximum":1000},"power_hp":{"description":"Used only when power_kw is absent","type":"number","minimum":3,"maximum":1400},"engine_cc":{"type":"integer","minimum":40,"maximum":20000},"fuel":{"type":"string","enum":["petrol","diesel","lpg","cng","hybrid","plugin_hybrid","electric","hydrogen","other"]},"transmission":{"type":"string","enum":["manual","automatic","semi_automatic"]},"drivetrain":{"type":"string","enum":["fwd","rwd","awd"]},"body_type":{"type":"string","enum":["sedan","hatchback","wagon","suv","coupe","convertible","minivan","van","pickup","other"]},"doors":{"type":"integer","minimum":2,"maximum":5},"condition":{"description":"Defaults to used","type":"string","enum":["used","new"]},"seller_type":{"type":"string","enum":["private","dealer"]},"city":{"type":"string","minLength":1,"maxLength":80},"equipment":{"maxItems":150,"type":"array","items":{"type":"string","minLength":1,"maxLength":50}},"owners_count":{"type":"integer","minimum":1,"maximum":20},"customs_cleared":{"type":"boolean"},"service_history":{"type":"boolean"},"category":{"description":"Motorcycles: type (Naked, Scooter, Enduro…); trucks: body (Kiper, Kombi…). See /v1/taxonomy/values","type":"string","minLength":1,"maxLength":60},"abs":{"description":"Motorcycles","type":"boolean"},"axles":{"description":"Trucks","type":"integer","minimum":1,"maximum":6},"payload_class":{"description":"Trucks: payload band, see /v1/taxonomy/values","type":"string","minLength":1,"maxLength":40}},"required":["make","model","year","mileage_km"],"additionalProperties":false},"kind":{"type":"string","enum":["owned","wanted"],"description":"owned: follow its value as it ages; wanted: follow the market price of that spec"},"label":{"type":"string","minLength":1,"maxLength":120},"external_ref":{"description":"Your own id (a user or vehicle)","type":"string","minLength":1,"maxLength":120},"km_per_year":{"description":"Owned vehicles: mileage advances by this much a year","type":"integer","minimum":0,"maximum":150000},"alerts":{"type":"object","properties":{"change_pct":{"description":"Alert when the value moves this many percent (from the baseline, then from the last alert)","anyOf":[{"type":"number","minimum":3,"maximum":90},{"type":"null"}]},"direction":{"description":"Which moves count for change_pct; default any","type":"string","enum":["any","up","down"]},"below_bam":{"description":"Alert when the value falls below this price","anyOf":[{"type":"integer","minimum":100,"maximum":5000000},{"type":"null"}]},"above_bam":{"description":"Alert when the value rises above this price","anyOf":[{"type":"integer","minimum":100,"maximum":5000000},{"type":"null"}]},"exposure_pct":{"description":"Alert when the exposure (debt, insured sum, cost) reaches this percentage of the value (LTV)","anyOf":[{"type":"number","minimum":10,"maximum":300},{"type":"null"}]},"deal_pct":{"description":"Wanted vehicles: alert when a new listing of the spec asks this many percent under its Cifra price","anyOf":[{"type":"number","minimum":5,"maximum":50},{"type":"null"}]}},"additionalProperties":false},"exposure":{"type":"object","properties":{"kind":{"type":"string","enum":["financing","insured","cost"],"description":"financing: a loan or lease balance; insured: the insured sum; cost: what was paid"},"amount_bam":{"type":"integer","minimum":100,"maximum":20000000},"as_of":{"description":"The day amount_bam was true (default: today)","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"term_months":{"description":"financing: months left; the balance amortizes to balloon_bam","anyOf":[{"type":"integer","minimum":1,"maximum":240},{"type":"null"}]},"annual_rate_pct":{"description":"financing: nominal annual interest (annuity); 0 = straight-line","anyOf":[{"type":"number","minimum":0,"maximum":40},{"type":"null"}]},"balloon_bam":{"description":"financing: what is left at the end","anyOf":[{"type":"integer","minimum":0,"maximum":20000000},{"type":"null"}]}},"required":["kind","amount_bam"],"additionalProperties":false},"tags":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"description":"Your own grouping, e.g. a portfolio or a branch"},"note":{"type":"string","minLength":1,"maxLength":2000},"created_by":{"type":"string","minLength":8,"maxLength":64}},"required":["vehicle","kind"],"additionalProperties":false},"WatchBatchResult":{"type":"object","properties":{"object":{"type":"string","const":"list"},"created":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"watched_vehicle":{"type":"object","properties":{"object":{"type":"string","const":"watched_vehicle"},"id":{"type":"string"},"kind":{"type":"string","enum":["owned","wanted"]},"status":{"type":"string","enum":["active","paused"]},"label":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"note":{"type":["string","null"]},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"model":{"type":"string"},"make_name":{"type":["string","null"]},"model_name":{"type":["string","null"]}},"required":["vehicle_type","make","model","make_name","model_name"],"additionalProperties":{}},"mileage":{"type":"object","properties":{"today_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"given_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"given_on":{"type":"string"},"km_per_year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["today_km","given_km","given_on","km_per_year"],"additionalProperties":false},"alerts":{"type":"object","properties":{"change_pct":{"type":["number","null"]},"direction":{"type":"string","enum":["any","up","down"]},"below_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"above_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"exposure_pct":{"type":["number","null"]},"deal_pct":{"type":["number","null"]}},"required":["change_pct","direction","below_bam","above_bam","exposure_pct","deal_pct"],"additionalProperties":false},"exposure":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["financing","insured","cost"]},"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of":{"type":"string"},"term_months":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"annual_rate_pct":{"type":["number","null"]},"balloon_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"today_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ratio":{"type":["number","null"]}},"required":["kind","amount_bam","as_of","term_months","annual_rate_pct","balloon_bam","today_bam","ratio"],"additionalProperties":false},{"type":"null"}]},"baseline":{"type":"object","properties":{"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"on":{"type":"string"}},"required":["value","on"],"additionalProperties":false},"latest":{"anyOf":[{"type":"object","properties":{"on":{"type":"string"},"point":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"low":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"high":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence_grade":{"type":["string","null"]},"model_version":{"type":["string","null"]}},"required":["on","point","low","high","confidence_grade","model_version"],"additionalProperties":false},{"type":"null"}]},"forecast":{"anyOf":[{"type":"object","properties":{"km_per_year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["months","point","low","high"],"additionalProperties":false}}},"required":["km_per_year","points"],"additionalProperties":false},{"type":"null"}]},"change_since_baseline_pct":{"type":["number","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["object","id","kind","status","label","external_ref","tags","note","vehicle","mileage","alerts","exposure","baseline","latest","forecast","change_since_baseline_pct","created_at","updated_at"],"additionalProperties":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["index"],"additionalProperties":false}}},"required":["object","created","data"],"additionalProperties":false},"WatchBatch":{"type":"object","properties":{"items":{"minItems":1,"maxItems":500,"type":"array","items":{}}},"required":["items"],"additionalProperties":false},"WatchList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"watched_vehicle"},"id":{"type":"string"},"kind":{"type":"string","enum":["owned","wanted"]},"status":{"type":"string","enum":["active","paused"]},"label":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"note":{"type":["string","null"]},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"model":{"type":"string"},"make_name":{"type":["string","null"]},"model_name":{"type":["string","null"]}},"required":["vehicle_type","make","model","make_name","model_name"],"additionalProperties":{}},"mileage":{"type":"object","properties":{"today_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"given_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"given_on":{"type":"string"},"km_per_year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["today_km","given_km","given_on","km_per_year"],"additionalProperties":false},"alerts":{"type":"object","properties":{"change_pct":{"type":["number","null"]},"direction":{"type":"string","enum":["any","up","down"]},"below_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"above_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"exposure_pct":{"type":["number","null"]},"deal_pct":{"type":["number","null"]}},"required":["change_pct","direction","below_bam","above_bam","exposure_pct","deal_pct"],"additionalProperties":false},"exposure":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["financing","insured","cost"]},"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of":{"type":"string"},"term_months":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"annual_rate_pct":{"type":["number","null"]},"balloon_bam":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"today_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ratio":{"type":["number","null"]}},"required":["kind","amount_bam","as_of","term_months","annual_rate_pct","balloon_bam","today_bam","ratio"],"additionalProperties":false},{"type":"null"}]},"baseline":{"type":"object","properties":{"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"on":{"type":"string"}},"required":["value","on"],"additionalProperties":false},"latest":{"anyOf":[{"type":"object","properties":{"on":{"type":"string"},"point":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"low":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"high":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence_grade":{"type":["string","null"]},"model_version":{"type":["string","null"]}},"required":["on","point","low","high","confidence_grade","model_version"],"additionalProperties":false},{"type":"null"}]},"forecast":{"anyOf":[{"type":"object","properties":{"km_per_year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["months","point","low","high"],"additionalProperties":false}}},"required":["km_per_year","points"],"additionalProperties":false},{"type":"null"}]},"change_since_baseline_pct":{"type":["number","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["object","id","kind","status","label","external_ref","tags","note","vehicle","mileage","alerts","exposure","baseline","latest","forecast","change_since_baseline_pct","created_at","updated_at"],"additionalProperties":false}},"has_more":{"type":"boolean"}},"required":["object","data","has_more"],"additionalProperties":false},"WatchUpdate":{"type":"object","properties":{"label":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"external_ref":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"status":{"type":"string","enum":["active","paused"]},"km_per_year":{"anyOf":[{"type":"integer","minimum":0,"maximum":150000},{"type":"null"}]},"mileage_km":{"type":"integer","minimum":0,"maximum":2000000},"alerts":{"type":"object","properties":{"change_pct":{"description":"Alert when the value moves this many percent (from the baseline, then from the last alert)","anyOf":[{"type":"number","minimum":3,"maximum":90},{"type":"null"}]},"direction":{"description":"Which moves count for change_pct; default any","type":"string","enum":["any","up","down"]},"below_bam":{"description":"Alert when the value falls below this price","anyOf":[{"type":"integer","minimum":100,"maximum":5000000},{"type":"null"}]},"above_bam":{"description":"Alert when the value rises above this price","anyOf":[{"type":"integer","minimum":100,"maximum":5000000},{"type":"null"}]},"exposure_pct":{"description":"Alert when the exposure (debt, insured sum, cost) reaches this percentage of the value (LTV)","anyOf":[{"type":"number","minimum":10,"maximum":300},{"type":"null"}]},"deal_pct":{"description":"Wanted vehicles: alert when a new listing of the spec asks this many percent under its Cifra price","anyOf":[{"type":"number","minimum":5,"maximum":50},{"type":"null"}]}},"additionalProperties":false},"exposure":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["financing","insured","cost"],"description":"financing: a loan or lease balance; insured: the insured sum; cost: what was paid"},"amount_bam":{"type":"integer","minimum":100,"maximum":20000000},"as_of":{"description":"The day amount_bam was true (default: today)","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"term_months":{"description":"financing: months left; the balance amortizes to balloon_bam","anyOf":[{"type":"integer","minimum":1,"maximum":240},{"type":"null"}]},"annual_rate_pct":{"description":"financing: nominal annual interest (annuity); 0 = straight-line","anyOf":[{"type":"number","minimum":0,"maximum":40},{"type":"null"}]},"balloon_bam":{"description":"financing: what is left at the end","anyOf":[{"type":"integer","minimum":0,"maximum":20000000},{"type":"null"}]}},"required":["kind","amount_bam"],"additionalProperties":false},{"type":"null"}]},"tags":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"description":"Your own grouping, e.g. a portfolio or a branch"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"additionalProperties":false},"WatchDeleted":{"type":"object","properties":{"object":{"type":"string","const":"watched_vehicle"},"id":{"type":"string"},"deleted":{"type":"boolean","const":true}},"required":["object","id","deleted"],"additionalProperties":false},"WatchHistory":{"type":"object","properties":{"object":{"type":"string","const":"list"},"watched_vehicle_id":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string"},"change_pct":{"type":["number","null"]},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"model_version":{"type":["string","null"]}},"required":["day","point","low","high","confidence_grade","change_pct","mileage_km","model_version"],"additionalProperties":false}}},"required":["object","watched_vehicle_id","from","to","data"],"additionalProperties":false},"WatchReport":{"type":"object","properties":{"object":{"type":"string","const":"watchlist_report"},"day":{"type":"string"},"summary":{"type":"object","properties":{"vehicles":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"valued":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"up":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"down":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"alerts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["vehicles","valued","up","down","alerts"],"additionalProperties":false},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"kind":{"type":"string","enum":["owned","wanted"]},"status":{"type":"string","enum":["active","paused"]},"tags":{"type":"array","items":{"type":"string"}},"value":{"anyOf":[{"type":"object","properties":{"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"high":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence_grade":{"type":"string","enum":["A","B","C"]}},"required":["point","low","high","confidence_grade"],"additionalProperties":false},{"type":"null"}]},"previous":{"anyOf":[{"type":"object","properties":{"day":{"type":"string"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","point"],"additionalProperties":false},{"type":"null"}]},"change_pct":{"type":["number","null"]},"change_since_baseline_pct":{"type":["number","null"]},"exposure":{"anyOf":[{"type":"object","properties":{"amount_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ratio":{"type":"number"}},"required":["amount_bam","ratio"],"additionalProperties":false},{"type":"null"}]},"alerts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"alert"},"id":{"type":"string"},"type":{"type":"string","enum":["value_changed","below_target","above_target","exposure_above","market_deal"]},"watched_vehicle":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"kind":{"type":"string","enum":["owned","wanted"]}},"required":["id","label","external_ref","kind"],"additionalProperties":false},"day":{"type":"string"},"previous_value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"change_pct":{"type":"number"},"threshold":{"type":"number"},"details":{"anyOf":[{"type":"object","properties":{"exposure":{"type":"object","properties":{"kind":{"type":"string"},"amount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ratio":{"type":"number"}},"required":["kind","amount","ratio"],"additionalProperties":false},"listing":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"km":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fairPrice":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"place":{"type":["string","null"]},"url":{"type":["string","null"]},"seller":{"type":["string","null"]}},"required":["id","title","year","km","price","fairPrice","place","url","seller"],"additionalProperties":false},"modelChanged":{"type":"object","properties":{"from":{"type":["string","null"]},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false}},"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string"}},"required":["object","id","type","watched_vehicle","day","previous_value","value","change_pct","threshold","details","created_at"],"additionalProperties":false}}},"required":["id","label","external_ref","kind","status","tags","value","previous","change_pct","change_since_baseline_pct","exposure","alerts"],"additionalProperties":false}}},"required":["object","day","summary","data"],"additionalProperties":false},"AlertList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"alert"},"id":{"type":"string"},"type":{"type":"string","enum":["value_changed","below_target","above_target","exposure_above","market_deal"]},"watched_vehicle":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"kind":{"type":"string","enum":["owned","wanted"]}},"required":["id","label","external_ref","kind"],"additionalProperties":false},"day":{"type":"string"},"previous_value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"change_pct":{"type":"number"},"threshold":{"type":"number"},"details":{"anyOf":[{"type":"object","properties":{"exposure":{"type":"object","properties":{"kind":{"type":"string"},"amount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ratio":{"type":"number"}},"required":["kind","amount","ratio"],"additionalProperties":false},"listing":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"km":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fairPrice":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"place":{"type":["string","null"]},"url":{"type":["string","null"]},"seller":{"type":["string","null"]}},"required":["id","title","year","km","price","fairPrice","place","url","seller"],"additionalProperties":false},"modelChanged":{"type":"object","properties":{"from":{"type":["string","null"]},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false}},"additionalProperties":false},{"type":"null"}]},"created_at":{"type":"string"}},"required":["object","id","type","watched_vehicle","day","previous_value","value","change_pct","threshold","details","created_at"],"additionalProperties":false}},"has_more":{"type":"boolean"}},"required":["object","data","has_more"],"additionalProperties":false},"WebhookCreated":{"type":"object","properties":{"object":{"type":"string","const":"webhook_endpoint"},"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"status":{"type":"string","enum":["active","disabled"]},"secret_hint":{"type":"string"},"created_at":{"type":"string"},"disabled_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"secret":{"type":"string"}},"required":["object","id","url","events","description","status","secret_hint","created_at","disabled_at","secret"],"additionalProperties":false},"WebhookCreate":{"type":"object","properties":{"url":{"type":"string","minLength":8,"maxLength":2048},"events":{"maxItems":9,"type":"array","items":{"type":"string","enum":["watchlist.alert","watchlist.report_ready","widget.rating_changed","report.created","check.completed","check.decided","bulk.completed","usage.threshold_reached","webhook.test"]}},"description":{"type":"string","maxLength":200}},"required":["url"],"additionalProperties":false},"WebhookList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","const":"webhook_endpoint"},"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"status":{"type":"string","enum":["active","disabled"]},"secret_hint":{"type":"string"},"created_at":{"type":"string"},"disabled_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["object","id","url","events","description","status","secret_hint","created_at","disabled_at"],"additionalProperties":false}}},"required":["object","data"],"additionalProperties":false},"WebhookEndpoint":{"type":"object","properties":{"object":{"type":"string","const":"webhook_endpoint"},"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"status":{"type":"string","enum":["active","disabled"]},"secret_hint":{"type":"string"},"created_at":{"type":"string"},"disabled_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["object","id","url","events","description","status","secret_hint","created_at","disabled_at"],"additionalProperties":false},"WebhookTest":{"type":"object","properties":{"object":{"type":"string","const":"webhook_delivery"},"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"event_id":{"type":"string"}},"required":["object","id","event_id"],"additionalProperties":false},"DeliveryList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"event_id":{"type":"string"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","sending","succeeded","failed"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_attempt_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"type":["string","null"]},"duration_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","event_id","event_type","status","attempts","next_attempt_at","last_status_code","last_error","duration_ms","created_at","delivered_at"],"additionalProperties":false}}},"required":["object","data"],"additionalProperties":false},"Widget":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"widget"},"public_id":{"type":"string"},"status":{"type":"string","enum":["active","paused","sold"]},"source":{"type":"string","enum":["valuation","report"]},"report_id":{"type":["string","null"]},"valuation_id":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"title":{"type":["string","null"]},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"model":{"type":"string"},"make_name":{"type":"string"},"model_name":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fuel":{"type":["string","null"]},"transmission":{"type":["string","null"]},"power_kw":{"type":["number","null"]}},"required":["vehicle_type","make","model","make_name","model_name","year","mileage_km","fuel","transmission","power_kw"],"additionalProperties":false},"asking_price":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"high":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence_grade":{"anyOf":[{"type":"string","enum":["A","B","C"]},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["currency","point","low","high","confidence_grade","as_of"],"additionalProperties":false},{"type":"null"}]},"rating":{"anyOf":[{"type":"object","properties":{"level":{"type":"string","enum":["great","good","fair","high","over"]},"pct":{"type":"number"},"diff_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["level","pct","diff_bam"],"additionalProperties":false},{"type":"null"}]},"embed":{"type":"object","properties":{"page_url":{"type":"string"},"script":{"type":"string"},"iframe":{"type":"string"}},"required":["page_url","script","iframe"],"additionalProperties":false},"sold_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","public_id","status","source","report_id","valuation_id","external_ref","title","vehicle","asking_price","value","rating","embed","sold_at","created_at","updated_at"],"additionalProperties":false},"WidgetCreate":{"type":"object","properties":{"valuation_id":{"description":"A valuation made with one of your company's live keys (val_…)","type":"string","minLength":1,"maxLength":64},"report_id":{"description":"Cifra's own platform only: a report of the company","type":"string","minLength":1,"maxLength":64},"asking_price":{"description":"Your asking price in KM, rated against the market value","anyOf":[{"type":"integer","minimum":100,"maximum":10000000},{"type":"null"}]},"external_ref":{"description":"Your own reference (stock number), unique among your live widgets","anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"title":{"description":"The name the widgets show; default make, model and year","anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"listing_id":{"description":"Cifra's own platform only","anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"price_from_listing":{"description":"Cifra's own platform only","type":"boolean"},"created_by":{"description":"Cifra's own platform only","type":"string","maxLength":64},"status":{"description":"paused: published but not shown yet","type":"string","enum":["active","paused"]}},"additionalProperties":false},"WidgetBatchResult":{"type":"object","properties":{"object":{"type":"string","const":"list"},"created":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"data":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"widget":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"widget"},"public_id":{"type":"string"},"status":{"type":"string","enum":["active","paused","sold"]},"source":{"type":"string","enum":["valuation","report"]},"report_id":{"type":["string","null"]},"valuation_id":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"title":{"type":["string","null"]},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"model":{"type":"string"},"make_name":{"type":"string"},"model_name":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fuel":{"type":["string","null"]},"transmission":{"type":["string","null"]},"power_kw":{"type":["number","null"]}},"required":["vehicle_type","make","model","make_name","model_name","year","mileage_km","fuel","transmission","power_kw"],"additionalProperties":false},"asking_price":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"high":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence_grade":{"anyOf":[{"type":"string","enum":["A","B","C"]},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["currency","point","low","high","confidence_grade","as_of"],"additionalProperties":false},{"type":"null"}]},"rating":{"anyOf":[{"type":"object","properties":{"level":{"type":"string","enum":["great","good","fair","high","over"]},"pct":{"type":"number"},"diff_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["level","pct","diff_bam"],"additionalProperties":false},{"type":"null"}]},"embed":{"type":"object","properties":{"page_url":{"type":"string"},"script":{"type":"string"},"iframe":{"type":"string"}},"required":["page_url","script","iframe"],"additionalProperties":false},"sold_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","public_id","status","source","report_id","valuation_id","external_ref","title","vehicle","asking_price","value","rating","embed","sold_at","created_at","updated_at"],"additionalProperties":false},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["index"],"additionalProperties":false}}},"required":["object","created","data"],"additionalProperties":false},"WidgetBatch":{"type":"object","properties":{"items":{"minItems":1,"maxItems":500,"type":"array","items":{}}},"required":["items"],"additionalProperties":false},"WidgetListResult":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"widget"},"public_id":{"type":"string"},"status":{"type":"string","enum":["active","paused","sold"]},"source":{"type":"string","enum":["valuation","report"]},"report_id":{"type":["string","null"]},"valuation_id":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"title":{"type":["string","null"]},"vehicle":{"type":"object","properties":{"vehicle_type":{"type":"string","enum":["car","motorcycle","truck"]},"make":{"type":"string"},"model":{"type":"string"},"make_name":{"type":"string"},"model_name":{"type":"string"},"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mileage_km":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fuel":{"type":["string","null"]},"transmission":{"type":["string","null"]},"power_kw":{"type":["number","null"]}},"required":["vehicle_type","make","model","make_name","model_name","year","mileage_km","fuel","transmission","power_kw"],"additionalProperties":false},"asking_price":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"currency":{"type":"string","const":"BAM"},"point":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"high":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence_grade":{"anyOf":[{"type":"string","enum":["A","B","C"]},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["currency","point","low","high","confidence_grade","as_of"],"additionalProperties":false},{"type":"null"}]},"rating":{"anyOf":[{"type":"object","properties":{"level":{"type":"string","enum":["great","good","fair","high","over"]},"pct":{"type":"number"},"diff_bam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["level","pct","diff_bam"],"additionalProperties":false},{"type":"null"}]},"embed":{"type":"object","properties":{"page_url":{"type":"string"},"script":{"type":"string"},"iframe":{"type":"string"}},"required":["page_url","script","iframe"],"additionalProperties":false},"sold_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","object","public_id","status","source","report_id","valuation_id","external_ref","title","vehicle","asking_price","value","rating","embed","sold_at","created_at","updated_at"],"additionalProperties":false}},"has_more":{"type":"boolean"}},"required":["object","data","has_more"],"additionalProperties":false},"WidgetUpdate":{"type":"object","properties":{"asking_price":{"description":"A new asking price (null: show only the value)","anyOf":[{"type":"integer","minimum":100,"maximum":10000000},{"type":"null"}]},"external_ref":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"title":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"status":{"type":"string","enum":["active","paused"]},"mileage_km":{"type":"integer","minimum":0,"maximum":3000000},"price_from_listing":{"type":"boolean"}},"additionalProperties":false},"WidgetDeleted":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"widget"},"deleted":{"type":"boolean","const":true}},"required":["id","object","deleted"],"additionalProperties":false}}},"paths":{"/v1/valuations":{"post":{"operationId":"valuationsCreate","tags":["Valuations"],"summary":"Value a vehicle","x-cifra-units":"1 per call","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValuationRequest"},"example":{"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"]}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Valuation"},"examples":{"example1":{"summary":"Potpun unos","value":{"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."},"comparables":{"total":502,"items":[{"year":2017,"mileage_km":154115,"fuel":"diesel","transmission":"manual","power_kw":85,"engine_cc":1600,"city":"Bihać","asking_price_bam":20999,"cifra_value_bam":22370,"price_vs_value_pct":-6.1,"days_listed":103},{"year":2017,"mileage_km":160000,"fuel":"diesel","transmission":"manual","power_kw":85,"engine_cc":1600,"city":"Bijeljina","asking_price_bam":23500,"cifra_value_bam":22480,"price_vs_value_pct":4.5,"days_listed":70},{"year":2017,"mileage_km":142000,"fuel":"diesel","transmission":"manual","power_kw":85,"engine_cc":1600,"city":"Konjic","asking_price_bam":27300,"cifra_value_bam":22520,"price_vs_value_pct":21.2,"days_listed":43}]},"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":[]}},"example2":{"summary":"Samo obavezna polja","value":{"id":"val_gcizgqyFRuEGurraw8v6","object":"valuation","created_at":"2026-10-18T21:57:27.584Z","model_version":"car-20261017-1","valued_by":{"kind":"standard","version":"car-20261017-1"},"vehicle":{"vehicle_type":"car","make":"škoda","make_name":"Škoda","model":"octavia","model_name":"Octavia","year":2015,"mileage_km":210000},"as_of":"2026-10-18","market_value":{"currency":"BAM","point":15600,"low":12370,"high":19690,"confidence_grade":"B","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."},"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":[{"code":"partial_inputs","message":"Add power, engine size, fuel and transmission for a tighter range."}]}},"example3":{"summary":"Model kompanije","value":{"id":"val_Qm4tR8wZk2Lc7VbN1xPe","object":"valuation","created_at":"2026-10-18T21:57:02.773Z","model_version":"custom-17-v3","valued_by":{"kind":"custom","version":"custom-17-v3","custom_model_id":17,"name":"Otkup 2026","price_kind":"purchase","base_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":20480,"low":18150,"high":22900,"confidence_grade":"A","range_probability":0.8,"definition":"The purchase price as your company's model \"Otkup 2026\" values it, learned from your own data on top of the standard market model; the range holds the price with 80% probability. standard_value is the market value."},"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":[],"standard_value":{"currency":"BAM","point":22350,"low":18610,"high":26790,"confidence_grade":"A","model_version":"car-20261017-1"}}},"example4":{"summary":"Na dan štete","value":{"id":"val_jiHvhLAgfiXC2R5xxuNK","object":"valuation","created_at":"2026-10-18T21:57:27.797Z","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":140000},"as_of":"2026-03-15","market_value":{"currency":"BAM","point":23700,"low":19450,"high":29160,"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."},"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":[{"code":"partial_inputs","message":"Add engine size for a tighter range."}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: pinned_model_unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457). code: unknown_make, unknown_model, vehicle_type_unavailable, as_of_in_future, as_of_too_early, year_after_as_of","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited, quota_exceeded, key_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457). code: model_unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/valuations/batch":{"post":{"operationId":"valuationsBatch","tags":["Valuations"],"summary":"Value many vehicles","x-cifra-units":"1 per item","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequest"},"example":{"include":["explanation"],"items":[{"make":"audi","model":"a4","year":2016,"mileage_km":190000,"fuel":"diesel","transmission":"automatic"},{"make":"škoda","model":"octavia","year":2015,"mileage_km":210000},{"make":"volkswagen","model":"pasat","year":2015,"mileage_km":200000}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchResult"},"examples":{"example1":{"summary":"Tri vozila","value":{"object":"list","data":[{"index":0,"valuation":{"id":"val_lbVQ4f6WuLaD9h85G4Gf","object":"valuation","created_at":"2026-10-18T22:04:59.768Z","model_version":"car-20261017-1","valued_by":{"kind":"standard","version":"car-20261017-1"},"vehicle":{"vehicle_type":"car","make":"audi","make_name":"Audi","model":"a4","model_name":"A4","year":2016,"mileage_km":190000},"as_of":"2026-10-18","market_value":{"currency":"BAM","point":29450,"low":24170,"high":36240,"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":22390},{"id":"mileage","label":"Kilometraža","amount_bam":1370},{"id":"equipment","label":"Oprema i motorizacija","amount_bam":6190},{"id":"history","label":"Stanje i historija vozila","amount_bam":-10},{"id":"region","label":"Regionalna potražnja","amount_bam":-290},{"id":"market","label":"Stanje tržišta","amount_bam":-200}],"method":"TreeSHAP contributions of the valuation model, grouped by factor and applied in order."},"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":[{"code":"partial_inputs","message":"Add power and engine size for a tighter range."}]}},{"index":1,"valuation":{"id":"val_Hc2WqLx9TzE4nVb7RkPa","object":"valuation","created_at":"2026-10-18T21:57:27.584Z","model_version":"car-20261017-1","valued_by":{"kind":"standard","version":"car-20261017-1"},"vehicle":{"vehicle_type":"car","make":"škoda","make_name":"Škoda","model":"octavia","model_name":"Octavia","year":2015,"mileage_km":210000},"as_of":"2026-10-18","market_value":{"currency":"BAM","point":15600,"low":12370,"high":19690,"confidence_grade":"B","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."},"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":[{"code":"partial_inputs","message":"Add power, engine size, fuel and transmission for a tighter range."}]}},{"index":2,"error":{"code":"unknown_model","detail":"Unknown model \"pasat\" for Volkswagen. See GET /v1/taxonomy/makes/volkswagen/models."}}],"valued":2,"failed":1}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: batch_too_large, payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited, quota_exceeded, key_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Problem details (RFC 9457). code: model_unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/valuations/{id}":{"get":{"operationId":"valuationsRetrieve","tags":["Valuations"],"summary":"Retrieve a valuation","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"val_yXpheA0qNLw6gYKCq6k1"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoredValuation"},"examples":{"example1":{"summary":"Procjena","value":{"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"]}}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/valuations/{id}/outcome":{"post":{"operationId":"valuationsOutcome","tags":["Valuations"],"summary":"Report the realized sale price","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"val_yXpheA0qNLw6gYKCq6k1"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Outcome"},"example":{"sold_price_bam":21500,"sold_at":"2026-10-25"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeResult"},"examples":{"example1":{"summary":"Prodano","value":{"object":"valuation_outcome","id":4812,"valuation_id":"val_yXpheA0qNLw6gYKCq6k1","sold_price_bam":21500,"created_at":"2026-10-26T08:14:51.120Z"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/taxonomy/makes":{"get":{"operationId":"taxonomyMakes","tags":["Taxonomy"],"summary":"List makes","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"vehicle_type","in":"query","required":false,"schema":{"default":"car","type":"string","enum":["car","motorcycle","truck"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Makes"},"examples":{"example1":{"summary":"Automobili","value":{"object":"list","data":[{"slug":"alfa_romeo","name":"Alfa Romeo","models":16},{"slug":"alpina","name":"Alpina","models":2},{"slug":"aston_martin","name":"Aston Martin","models":4},{"slug":"audi","name":"Audi","models":54}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_vehicle_type, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/taxonomy/makes/{make}/models":{"get":{"operationId":"taxonomyModels","tags":["Taxonomy"],"summary":"List models of a make","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"make","in":"path","required":true,"schema":{"type":"string"},"example":"volkswagen"},{"name":"vehicle_type","in":"query","required":false,"schema":{"default":"car","type":"string","enum":["car","motorcycle","truck"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Models"},"examples":{"example1":{"summary":"Volkswagen","value":{"object":"list","data":[{"slug":"golf","name":"Golf"},{"slug":"golf_6","name":"Golf 6"},{"slug":"golf_7","name":"Golf 7"},{"slug":"golf_7_gti","name":"Golf 7 GTI"},{"slug":"golf_8","name":"Golf 8"}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_vehicle_type, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457). code: unknown_make","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/taxonomy/values":{"get":{"operationId":"taxonomyValues","tags":["Taxonomy"],"summary":"Accepted values of enum fields","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"vehicle_type","in":"query","required":false,"schema":{"default":"car","type":"string","enum":["car","motorcycle","truck"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Values"},"examples":{"example1":{"summary":"Automobili","value":{"fuel":["petrol","diesel","lpg","cng","hybrid","plugin_hybrid","electric","hydrogen","other"],"transmission":["manual","automatic","semi_automatic"],"drivetrain":["fwd","rwd","awd"],"body_type":["sedan","hatchback","wagon","suv","coupe","convertible","minivan","van","pickup","other"],"condition":["used","new"],"seller_type":["private","dealer"]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_vehicle_type, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/vehicle-history":{"get":{"operationId":"vehicleHistoryRetrieve","tags":["Vehicle history"],"summary":"A vehicle's listing history and risk signals","x-cifra-units":"1 per call","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"listing_url","in":"query","required":false,"schema":{"type":"string","maxLength":500,"format":"uri"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["olx","autobum","autoplac"]}},{"name":"listing_id","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{1,20}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleHistory"},"examples":{"example1":{"summary":"Ponovno oglašen kombi","value":{"object":"vehicle_history","query":{"source":"olx","listing_id":"61234567"},"vehicle":{"make":"Volkswagen","model":"T6 Kombi","year":2016,"fuel":"diesel","power_kw":75},"identity":{"listings":3,"sites":2,"first_seen_on":"2026-06-25","last_seen_on":"2026-10-18","mileage_range_km":[255000,256000],"confidence":0.5},"listings":[{"source":"olx","is_query":false,"status":"active","listed_on":"2026-06-25","last_seen_on":"2026-10-17","days_listed":113,"mileage_km":255540,"first_price_bam":32000,"last_price_bam":30000,"city":"Tuzla","link":null},{"source":"autobum","is_query":false,"status":"active","listed_on":"2026-09-06","last_seen_on":"2026-10-18","days_listed":42,"mileage_km":255000,"first_price_bam":30000,"last_price_bam":30000,"city":"Tuzla","link":{"confidence":0.818,"matched_on":["same_city","same_power","close_mileage","similar_price","similar_title"],"mileage_change_km":-540,"days_after_previous":73}},{"source":"olx","is_query":true,"status":"active","listed_on":"2026-10-16","last_seen_on":"2026-10-18","days_listed":1,"mileage_km":256000,"first_price_bam":34000,"last_price_bam":34000,"city":"Tuzla","link":{"confidence":0.5,"matched_on":["same_city","same_power","close_mileage","similar_price","similar_title"],"mileage_change_km":1000,"days_after_previous":40}}],"level":"elevated","signals":[{"code":"relisted_often","severity":"medium","summary":"Na prodaji 5 mj., oglašeno 3 puta","message":"Prvi oglas 25. 6. 2026. Vozilo koje se dugo ne proda često ima razlog — cijenu, stanje ili papire.","check":"Pitajte koliko dugo se prodaje i zašto se još nije prodalo."},{"code":"changed_hands","severity":"info","summary":"Mijenjalo prodavca","message":"Vozilo je nudio više od jednog prodavca; pogledajte historiju.","check":null}],"in_favour":[{"code":"mileage_consistent","summary":"Kilometraža raste dosljedno kroz oglase"}],"market":{"asking_price_bam":34000,"cifra_price_bam":28100,"vs_market":0.21,"mileage_percentile_for_age":0.57},"note":"Matches come from listing data (specs, mileage trail, title, seller, place, photos), not a vehicle registry. Signals are reasons to look closer, not verdicts. Signal texts are in Bosnian, as on Cifra's reports."}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: listing_not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://api.cifra.ba/errors/listing_not_found","title":"Not Found","status":404,"code":"listing_not_found","detail":"We haven't seen this listing. It may be new (sites are scanned daily) or from a site we don't cover.","request_id":"5b9e0d7a-3c41-4e8f-9a26-0f4d8b1c2e73"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457). code: unsupported_listing_url","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited, quota_exceeded, key_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/watchlist":{"post":{"operationId":"watchlistCreate","tags":["Watchlist"],"summary":"Watch a vehicle","x-cifra-units":"1 per call","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchCreate"},"example":{"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"]}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchedVehicle"},"examples":{"example1":{"summary":"Vozilo na lizingu","value":{"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"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: watchlist_full","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457). code: unknown_make, unknown_model, vehicle_type_unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited, quota_exceeded, key_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"operationId":"watchlistList","tags":["Watchlist"],"summary":"List watched vehicles","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"external_ref","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","paused"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchList"},"examples":{"example1":{"summary":"Po vašoj oznaci","value":{"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}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/watchlist/batch":{"post":{"operationId":"watchlistBatch","tags":["Watchlist"],"summary":"Watch many vehicles","x-cifra-units":"1 per item","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchBatch"},"example":{"items":[{"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"]},{"kind":"wanted","label":"Traži: Octavia 2018+","vehicle":{"make":"škoda","model":"octavia","year":2018,"mileage_km":150000,"fuel":"diesel"},"alerts":{"deal_pct":12}}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchBatchResult"},"examples":{"example1":{"summary":"Dva vozila","value":{"object":"list","created":1,"data":[{"index":0,"watched_vehicle":{"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"}},{"index":1,"error":{"code":"watchlist_full","message":"This plan allows 1000 watched vehicles (1000 now); delete some or upgrade."}}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: watchlist_full","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited, quota_exceeded, key_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/watchlist/{id}":{"get":{"operationId":"watchlistRetrieve","tags":["Watchlist"],"summary":"Retrieve a watched vehicle","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wv_3JdP0aZr6YcN2uE5kHq8"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchedVehicle"},"examples":{"example1":{"summary":"Vozilo","value":{"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"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"operationId":"watchlistUpdate","tags":["Watchlist"],"summary":"Update a watched vehicle","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wv_3JdP0aZr6YcN2uE5kHq8"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchUpdate"},"example":{"mileage_km":151200,"alerts":{"change_pct":4},"exposure":{"kind":"financing","amount_bam":18425,"as_of":"2026-11-01","term_months":35,"annual_rate_pct":6.9,"balloon_bam":12000}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchedVehicle"},"examples":{"example1":{"summary":"Novo očitanje i stanje kredita","value":{"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":151200,"given_km":151200,"given_on":"2026-11-01","km_per_year":18000},"alerts":{"change_pct":4,"direction":"down","below_bam":null,"above_bam":null,"exposure_pct":85,"deal_pct":null},"exposure":{"kind":"financing","amount_bam":18425,"as_of":"2026-11-01","term_months":35,"annual_rate_pct":6.9,"balloon_bam":12000,"today_bam":18425,"ratio":0.8244},"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-11-01T10:02:37.118Z"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Problem details (RFC 9457). code: not_owned, not_wanted","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"operationId":"watchlistDelete","tags":["Watchlist"],"summary":"Stop watching a vehicle","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wv_3JdP0aZr6YcN2uE5kHq8"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchDeleted"},"examples":{"example1":{"summary":"Uklonjeno","value":{"object":"watched_vehicle","id":"wv_3JdP0aZr6YcN2uE5kHq8","deleted":true}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/watchlist/{id}/history":{"get":{"operationId":"watchlistHistory","tags":["Watchlist"],"summary":"Daily values of a watched vehicle","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wv_3JdP0aZr6YcN2uE5kHq8"},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchHistory"},"examples":{"example1":{"summary":"Četiri dana","value":{"object":"list","watched_vehicle_id":"wv_3JdP0aZr6YcN2uE5kHq8","from":"2026-10-18","to":"2026-10-21","data":[{"day":"2026-10-18","point":22350,"low":18610,"high":26790,"confidence_grade":"A","change_pct":null,"mileage_km":148000,"model_version":"car-20261017-1"},{"day":"2026-10-19","point":22330,"low":18590,"high":26770,"confidence_grade":"A","change_pct":-0.09,"mileage_km":148049,"model_version":"car-20261017-1"},{"day":"2026-10-20","point":22310,"low":18580,"high":26740,"confidence_grade":"A","change_pct":-0.09,"mileage_km":148099,"model_version":"car-20261017-1"},{"day":"2026-10-21","point":22300,"low":18570,"high":26730,"confidence_grade":"A","change_pct":-0.04,"mileage_km":148148,"model_version":"car-20261017-1"}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/watchlist/report":{"get":{"operationId":"watchlistReport","tags":["Watchlist"],"summary":"The daily watchlist report","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"day","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"external_ref","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchReport"},"examples":{"example1":{"summary":"Jutarnji izvještaj","value":{"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"}]}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/alerts":{"get":{"operationId":"alertsList","tags":["Alerts"],"summary":"List alerts","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"watched_vehicle_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertList"},"examples":{"example1":{"summary":"LTV i povoljan oglas","value":{"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}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/webhooks":{"post":{"operationId":"webhooksCreate","tags":["Webhooks"],"summary":"Add a webhook endpoint","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreate"},"example":{"url":"https://hooks.firma.ba/cifra","events":["watchlist.alert","watchlist.report_ready"],"description":"Produkcija — kreditni sistem"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreated"},"examples":{"example1":{"summary":"Alarmi i izvještaj","value":{"object":"webhook_endpoint","id":"whe_K7pX2mQ9vN4tR8bL1cZe","url":"https://hooks.firma.ba/cifra","events":["watchlist.alert","watchlist.report_ready"],"description":"Produkcija — kreditni sistem","status":"active","secret_hint":"…x9Qa","created_at":"2026-10-18T22:10:03.441Z","disabled_at":null,"secret":"whsec_4fJ8kL2mQ9xR7vT1bN6cZ3pW5yH0gD9x9Qa"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_webhook_url, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: too_many_webhooks","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"operationId":"webhooksList","tags":["Webhooks"],"summary":"List webhook endpoints","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookList"},"examples":{"example1":{"summary":"Adrese","value":{"object":"list","data":[{"object":"webhook_endpoint","id":"whe_K7pX2mQ9vN4tR8bL1cZe","url":"https://hooks.firma.ba/cifra","events":["watchlist.alert","watchlist.report_ready"],"description":"Produkcija — kreditni sistem","status":"active","secret_hint":"…x9Qa","created_at":"2026-10-18T22:10:03.441Z","disabled_at":null}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/webhooks/{id}":{"delete":{"operationId":"webhooksDelete","tags":["Webhooks"],"summary":"Disable a webhook endpoint","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"whe_K7pX2mQ9vN4tR8bL1cZe"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"examples":{"example1":{"summary":"Isključeno","value":{"object":"webhook_endpoint","id":"whe_K7pX2mQ9vN4tR8bL1cZe","url":"https://hooks.firma.ba/cifra","events":["watchlist.alert","watchlist.report_ready"],"description":"Produkcija — kreditni sistem","status":"disabled","secret_hint":"…x9Qa","created_at":"2026-10-18T22:10:03.441Z","disabled_at":"2026-11-02T09:00:12.000Z"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/webhooks/{id}/test":{"post":{"operationId":"webhooksTest","tags":["Webhooks"],"summary":"Send a test event","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"whe_K7pX2mQ9vN4tR8bL1cZe"}],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTest"},"examples":{"example1":{"summary":"Poslano","value":{"object":"webhook_delivery","id":90412,"event_id":"evt_2kQ9mX7vR4tL8bN1cZ5p"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: webhook_disabled","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/webhooks/{id}/deliveries":{"get":{"operationId":"webhooksDeliveries","tags":["Webhooks"],"summary":"Recent deliveries of an endpoint","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"whe_K7pX2mQ9vN4tR8bL1cZe"},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryList"},"examples":{"example1":{"summary":"Isporuke","value":{"object":"list","data":[{"id":90412,"event_id":"evt_2kQ9mX7vR4tL8bN1cZ5p","event_type":"webhook.test","status":"succeeded","attempts":1,"next_attempt_at":null,"last_status_code":200,"last_error":null,"duration_ms":184,"created_at":"2026-10-18T22:11:40.003Z","delivered_at":"2026-10-18T22:11:40.212Z"},{"id":90388,"event_id":"evt_7vT1bN6cZ3pW5yH0gD9x","event_type":"watchlist.alert","status":"pending","attempts":2,"next_attempt_at":"2026-10-18T07:12:44.000Z","last_status_code":503,"last_error":"HTTP 503","duration_ms":10000,"created_at":"2026-10-18T06:12:44.000Z","delivered_at":null}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/widgets":{"post":{"operationId":"widgetsCreate","tags":["Widgets"],"summary":"Publish a valuation as widgets","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetCreate"},"example":{"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","asking_price":23900,"external_ref":"LAG-0412"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Widget"},"examples":{"example1":{"summary":"Vozilo iz lagera","value":{"id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","object":"widget","public_id":"k3M9xQ2vTa","status":"active","source":"valuation","report_id":null,"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","external_ref":"LAG-0412","title":null,"vehicle":{"vehicle_type":"car","make":"volkswagen","model":"golf_7","make_name":"Volkswagen","model_name":"Golf 7","year":2017,"mileage_km":148000,"fuel":"diesel","transmission":"manual","power_kw":85},"asking_price":23900,"value":{"currency":"BAM","point":25750,"low":22600,"high":28900,"confidence_grade":"B","as_of":"2026-10-21"},"rating":{"level":"good","pct":-7.18,"diff_bam":-1850},"embed":{"page_url":"https://www.cifra.ba/w/k3M9xQ2vTa","script":"<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>","iframe":"<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"},"sold_at":null,"created_at":"2026-10-21T09:14:02.511Z","updated_at":"2026-10-21T09:14:02.640Z"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: organization_required, live_key_required, key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: valuation_not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: duplicate_external_ref, widget_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"operationId":"widgetsList","tags":["Widgets"],"summary":"List widgets","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"external_ref","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","paused","sold"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetListResult"},"examples":{"example1":{"summary":"Po vašoj oznaci","value":{"object":"list","data":[{"id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","object":"widget","public_id":"k3M9xQ2vTa","status":"active","source":"valuation","report_id":null,"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","external_ref":"LAG-0412","title":null,"vehicle":{"vehicle_type":"car","make":"volkswagen","model":"golf_7","make_name":"Volkswagen","model_name":"Golf 7","year":2017,"mileage_km":148000,"fuel":"diesel","transmission":"manual","power_kw":85},"asking_price":23900,"value":{"currency":"BAM","point":25750,"low":22600,"high":28900,"confidence_grade":"B","as_of":"2026-10-21"},"rating":{"level":"good","pct":-7.18,"diff_bam":-1850},"embed":{"page_url":"https://www.cifra.ba/w/k3M9xQ2vTa","script":"<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>","iframe":"<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"},"sold_at":null,"created_at":"2026-10-21T09:14:02.511Z","updated_at":"2026-10-21T09:14:02.640Z"}],"has_more":false}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: organization_required, key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/widgets/batch":{"post":{"operationId":"widgetsBatch","tags":["Widgets"],"summary":"Publish many valuations","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetBatch"},"example":{"items":[{"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","asking_price":23900,"external_ref":"LAG-0412"},{"valuation_id":"val_Q1wE2rT3yU4iO5pA6sD7","asking_price":31500,"external_ref":"LAG-0413"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetBatchResult"},"examples":{"example1":{"summary":"Dva vozila","value":{"object":"list","created":1,"data":[{"index":0,"widget":{"id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","object":"widget","public_id":"k3M9xQ2vTa","status":"active","source":"valuation","report_id":null,"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","external_ref":"LAG-0412","title":null,"vehicle":{"vehicle_type":"car","make":"volkswagen","model":"golf_7","make_name":"Volkswagen","model_name":"Golf 7","year":2017,"mileage_km":148000,"fuel":"diesel","transmission":"manual","power_kw":85},"asking_price":23900,"value":{"currency":"BAM","point":25750,"low":22600,"high":28900,"confidence_grade":"B","as_of":"2026-10-21"},"rating":{"level":"good","pct":-7.18,"diff_bam":-1850},"embed":{"page_url":"https://www.cifra.ba/w/k3M9xQ2vTa","script":"<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>","iframe":"<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"},"sold_at":null,"created_at":"2026-10-21T09:14:02.511Z","updated_at":"2026-10-21T09:14:02.640Z"}},{"index":1,"error":{"code":"valuation_not_found","message":"No such valuation made with this company's keys."}}]}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: organization_required, live_key_required, key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: widget_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/widgets/{id}":{"get":{"operationId":"widgetsRetrieve","tags":["Widgets"],"summary":"Retrieve a widget","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wgt_7Hq2Lm9PzX4cV1bN8sKd"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Widget"},"examples":{"example1":{"summary":"Widget","value":{"id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","object":"widget","public_id":"k3M9xQ2vTa","status":"active","source":"valuation","report_id":null,"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","external_ref":"LAG-0412","title":null,"vehicle":{"vehicle_type":"car","make":"volkswagen","model":"golf_7","make_name":"Volkswagen","model_name":"Golf 7","year":2017,"mileage_km":148000,"fuel":"diesel","transmission":"manual","power_kw":85},"asking_price":23900,"value":{"currency":"BAM","point":25750,"low":22600,"high":28900,"confidence_grade":"B","as_of":"2026-10-21"},"rating":{"level":"good","pct":-7.18,"diff_bam":-1850},"embed":{"page_url":"https://www.cifra.ba/w/k3M9xQ2vTa","script":"<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>","iframe":"<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"},"sold_at":null,"created_at":"2026-10-21T09:14:02.511Z","updated_at":"2026-10-21T09:14:02.640Z"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"operationId":"widgetsUpdate","tags":["Widgets"],"summary":"Update a widget","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wgt_7Hq2Lm9PzX4cV1bN8sKd"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetUpdate"},"example":{"asking_price":22900}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Widget"},"examples":{"example1":{"summary":"Nova cijena","value":{"id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","object":"widget","public_id":"k3M9xQ2vTa","status":"active","source":"valuation","report_id":null,"valuation_id":"val_8fK2mQ9xLp4TvB7nR1sW","external_ref":"LAG-0412","title":null,"vehicle":{"vehicle_type":"car","make":"volkswagen","model":"golf_7","make_name":"Volkswagen","model_name":"Golf 7","year":2017,"mileage_km":148000,"fuel":"diesel","transmission":"manual","power_kw":85},"asking_price":22900,"value":{"currency":"BAM","point":25750,"low":22600,"high":28900,"confidence_grade":"B","as_of":"2026-10-21"},"rating":{"level":"good","pct":-11.07,"diff_bam":-2850},"embed":{"page_url":"https://www.cifra.ba/w/k3M9xQ2vTa","script":"<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>","iframe":"<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"},"sold_at":null,"created_at":"2026-10-21T09:14:02.511Z","updated_at":"2026-10-21T09:14:02.640Z"}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_request, invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Problem details (RFC 9457). code: duplicate_external_ref, widget_limit_reached","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"operationId":"widgetsDelete","tags":["Widgets"],"summary":"Remove a widget","x-cifra-units":"free","security":[{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"wgt_7Hq2Lm9PzX4cV1bN8sKd"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetDeleted"},"examples":{"example1":{"summary":"Uklonjeno","value":{"id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","object":"widget","deleted":true}}}}}},"400":{"description":"Problem details (RFC 9457). code: invalid_body","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Problem details (RFC 9457). code: missing_token, invalid_token, token_expired","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Problem details (RFC 9457). code: key_paused, token_suspended, ip_not_allowed, insufficient_scope","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Problem details (RFC 9457). code: not_found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Problem details (RFC 9457). code: payload_too_large","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Problem details (RFC 9457). code: rate_limited","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Problem details (RFC 9457). code: internal_error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"webhooks":{"watchlist.alert":{"post":{"summary":"watchlist.alert","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"watchlist.alert","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"alert":{"object":"alert","id":"alr_8fK2mQ9xLp4TvB7nR1sW","type":"value_changed","watched_vehicle":{"id":"wv_3JdP0aZr6YcN2uE5kHq8","label":"VW Golf 1.6 TDI — ugovor 2024/118","external_ref":"2024/118","kind":"owned"},"day":"2026-10-15","previous_value":21400,"value":20550,"change_pct":-3.97,"threshold":3,"details":null,"created_at":"2026-10-15T06:12:44.000Z"}}}}}},"responses":{"2XX":{"description":"Received"}}}},"watchlist.report_ready":{"post":{"summary":"watchlist.report_ready","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"watchlist.report_ready","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"day":"2026-10-15","vehicles":412,"alerts":7,"report_url":"/v1/watchlist/report?day=2026-10-15"}}}}},"responses":{"2XX":{"description":"Received"}}}},"widget.rating_changed":{"post":{"summary":"widget.rating_changed","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"widget.rating_changed","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"widget":{"object":"widget","id":"wgt_7Hq2Lm9PzX4cV1bN8sKd","public_id":"k3M9xQ2vTa","external_ref":"LAG-0412","title":"Volkswagen Golf 7 1.6 TDI Highline","status":"active","asking_price":23900,"value":22950,"previous_level":"fair","level":"high","pct":4.14,"day":"2026-10-15"}}}}}},"responses":{"2XX":{"description":"Received"}}}},"report.created":{"post":{"summary":"report.created","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"report.created","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"report":{"object":"report","id":"cm2x8k1q00001","url":"https://enterprise.cifra.ba/valuations/cm2x8k1q00001","purpose":"financing","reference":"2024/118","vehicle":{"vehicle_type":"car","make":"volkswagen","model":"golf","make_name":"Volkswagen","model_name":"Golf","year":2019,"mileage_km":98000,"fuel":"diesel","transmission":"manual","power_kw":85},"value":20550,"low":19300,"high":21900,"currency":"BAM","grade":"A","as_of":"2026-10-15","created_by":{"name":"Amra Hodžić","email":"amra@firma.ba"},"created_at":"2026-10-15T09:41:12.000Z"}}}}}},"responses":{"2XX":{"description":"Received"}}}},"check.completed":{"post":{"summary":"check.completed","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"check.completed","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"check":{"object":"vehicle_check","id":"cm2x9a7d00004","url":"https://enterprise.cifra.ba/check/cm2x9a7d00004","vehicle":"Volkswagen Golf 2016","listing_url":"https://olx.ba/artikal/61234567","level":"elevated","headline":"Kilometraža niža nego u ranijem oglasu","signals":[{"code":"mileage_rollback","severity":"high"},{"code":"relisted_often","severity":"medium"}],"purpose":"financing","reference":"2024/118","created_by":{"name":"Amra Hodžić","email":"amra@firma.ba"},"checked_at":"2026-10-15T09:52:03.000Z"}}}}}},"responses":{"2XX":{"description":"Received"}}}},"check.decided":{"post":{"summary":"check.decided","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"check.decided","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"check":{"object":"vehicle_check","id":"cm2x9a7d00004","url":"https://enterprise.cifra.ba/check/cm2x9a7d00004","vehicle":"Volkswagen Golf 2016","level":"elevated","reference":"2024/118","decision":"review","decision_note":"Tražiti servisnu knjižicu prije odobrenja.","decided_by":{"name":"Emir Kovač","email":"emir@firma.ba"},"decided_at":"2026-10-15T10:05:27.000Z"}}}}}},"responses":{"2XX":{"description":"Received"}}}},"bulk.completed":{"post":{"summary":"bulk.completed","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"bulk.completed","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"batch":{"object":"valuation_batch","id":"cm2xa0b3k0009","url":"https://enterprise.cifra.ba/valuations/bulk/cm2xa0b3k0009","name":"Lizing portfelj Q3","purpose":"financing","as_of":"2026-09-30","rows":1240,"valued":1228,"failed":12,"total_value":24118400,"currency":"BAM","created_by":{"name":"Amra Hodžić","email":"amra@firma.ba"},"completed_at":"2026-10-15T11:20:45.000Z"}}}}}},"responses":{"2XX":{"description":"Received"}}}},"usage.threshold_reached":{"post":{"summary":"usage.threshold_reached","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"usage.threshold_reached","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"month":"2026-10","threshold_pct":80,"units":80214,"quota":100000,"resets_at":"2026-11-01T00:00:00.000Z"}}}}},"responses":{"2XX":{"description":"Received"}}}},"webhook.test":{"post":{"summary":"webhook.test","description":"Signed with `Cifra-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"<t>.<body>\">` using the endpoint's secret. De-duplicate on `Cifra-Event-Id`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","created_at","livemode","data"],"additionalProperties":false},"example":{"id":"evt_2kQ9mX7vR4tL8bN1cZ5p","type":"webhook.test","created_at":"2026-10-15T06:12:44.000Z","livemode":true,"data":{"message":"A test event from Cifra."}}}}},"responses":{"2XX":{"description":"Received"}}}}}}