{"openapi":"3.1.0","info":{"title":"AutoSignal public API","version":"1.0.0","summary":"Czech car-market deals, prices, valuations and the free registry vehicle check.","description":"AutoSignal watches the Czech (and SK / PL / HU / RO) car market: it aggregates adverts from the major marketplaces and dealer sites, groups them into segments of comparable cars (brand, model, fuel, country, year band, mileage band), computes each segment's median price and flags cars priced 12 %+ below it (5 % for new cars). It also runs a free check of any VIN against the official Czech vehicle registry.\n\nThis is the public, read-only slice of the API — the same data the website and apps show, no key needed (service health: GET /api/health). Everything here is also available as tools on the MCP server at `https://api.autosignal.eu/mcp` (operations carry `x-mcp-tool` with the tool name); see https://autosignal.eu/cs/mcp.\n\n**Rate limit:** 100 requests per minute per IP; a 429 says how long to wait in `retry-after`. Responses are cached for 2 minutes server-side, so polling faster returns the same data. (The vehicle check also allows 10 *live* registry lookups per IP per day; VINs in the monthly snapshot are free.)\n\n**Conventions:** all prices are gross CZK unless a `currency` field says otherwise; percentages are plain numbers (12.5 = 12.5 %); dates are ISO 8601; list parameters are comma-separated; ids are UUIDs. Figures are statistical (vs. segment median) and informational — not an expert appraisal. Methodology: https://autosignal.eu/cs/metodika. Terms: https://autosignal.eu/cs/terms.","termsOfService":"https://autosignal.eu/cs/terms","contact":{"name":"AutoSignal (HAIM X, s.r.o.)","email":"podpora@autosignal.eu","url":"https://autosignal.eu"},"license":{"name":"Public data, informational use. See terms.","url":"https://autosignal.eu/cs/terms"},"x-logo":{"url":"https://autosignal.eu/logo-icon.png"}},"externalDocs":{"description":"Methodology (how the median and deal threshold work)","url":"https://autosignal.eu/cs/metodika"},"servers":[{"url":"https://api.autosignal.eu","description":"Production"}],"tags":[{"name":"Deals","description":"Cars priced below their segment median, and the whole scored market."},{"name":"Market","description":"Trends, valuations and country snapshots."},{"name":"Prices","description":"Brand / model / model-year price statistics (the data behind autosignal.eu/cs/ceny)."},{"name":"Reports","description":"Monthly market reports."},{"name":"Registrations","description":"Czech new-car registrations by month (SDA-CIA)."},{"name":"Vehicle registry","description":"The free VIN check against the official Czech registry."},{"name":"Companies","description":"Registered fleets of Czech companies."},{"name":"Meta","description":"Service health."}],"paths":{"/api/deals":{"get":{"operationId":"searchDeals","x-mcp-tool":"search_deals","tags":["Deals"],"summary":"Search below-market deals (or the whole market)","description":"Paginated feed of cars priced 12 %+ below the median of comparable cars (same brand, model, fuel, country, year band, mileage band), one card per car, best deal first by default. `mode=all` returns every scored listing instead, each with its % above/below median. Pagination: request `page=1`, then `page+1` while `hasMore` is true (`total` is the number of cards; `pageSize` max 100). Cached for 2 minutes.","parameters":[{"$ref":"#/components/parameters/brands"},{"$ref":"#/components/parameters/models"},{"$ref":"#/components/parameters/fuels"},{"$ref":"#/components/parameters/vehicleTypes"},{"$ref":"#/components/parameters/bodyTypes"},{"$ref":"#/components/parameters/priceMin"},{"$ref":"#/components/parameters/priceMax"},{"$ref":"#/components/parameters/yearMin"},{"$ref":"#/components/parameters/yearMax"},{"$ref":"#/components/parameters/maxMileage"},{"$ref":"#/components/parameters/minDiscount"},{"$ref":"#/components/parameters/priceDropped"},{"$ref":"#/components/parameters/firstOwner"},{"$ref":"#/components/parameters/czOrigin"},{"$ref":"#/components/parameters/powerMin"},{"$ref":"#/components/parameters/transmission"},{"$ref":"#/components/parameters/damaged"},{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/mode"},{"$ref":"#/components/parameters/vehicleClass"},{"name":"source","in":"query","description":"Restrict to source slugs, comma-separated (e.g. sauto, tipcars, aaa-auto).","schema":{"type":"string","description":"Sources. Comma-separated list.","example":"sauto,tipcars"}},{"name":"sortBy","in":"query","description":"Sort order. `deal_score` (default) = biggest discount first; `date` = newest deal; `listed` = newest advert; `priceDropDate` = latest price cut.","schema":{"type":"string","enum":["deal_score","price","price_desc","date","listed","priceDropDate"],"default":"deal_score"}},{"name":"includeMarket","in":"query","description":"`true` appends rated non-deal listings after the deals so a narrow filter never dead-ends; `dealTotal` / `marketTotal` split the count.","schema":{"type":"string","enum":["true"]}},{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/pageSize"}],"responses":{"200":{"description":"A page of deal cards.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Deal"},"description":"One card per car (cross-posts collapse into `duplicates`), in the requested order."},"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"page":{"description":"The page returned (1-based).","type":"integer"},"pageSize":{"description":"Cards per page.","type":"integer"},"hasMore":{"description":"Another page exists.","type":"boolean"},"dealsTotal":{"type":"integer"},"marketTotal":{"description":"How many of the matching cards are market-tail rows; null when not computed yet.","type":"integer"}}},"example":{"data":[{"id":"228f2bd8-eed3-4f91-9bbf-bf038ce751f6","listingId":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","marketStatId":"431279b6-2f4c-4ff3-82ce-e9f73ae813fc","dealScore":0.66878456,"priceDiffPct":66.878456,"flaggedAt":"2026-09-12 08:15:09.348921+00","isPublished":true,"isMarketListing":false,"listing":{"id":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","source":"tipcars","sourceId":"15780215","url":"https://www.tipcars.com/suzuki-vitara/suv/nafta/suzuki-vitara-1-9-ddis-1-majitel-4x4-servisk-15780215.html","title":"Suzuki Vitara 1,9 DDiS 1.majitel,4x4,servisk","brand":"Suzuki","model":"Vitara","year":2008,"mileageKm":94448,"priceCzk":119900,"currency":"CZK","fuel":"other","transmission":null,"description":"","images":["https://img.tipcars.com/fotky_zdrojove/15780215_1/1748341826/E/suzuki-vitara-1-9-ddis-1-majitel-4x4-servisk.jpg"],"location":"","country":"CZ","vin":"JSAJTA44V00252629","sellerType":"dealer","sellerName":"Tomáš Lajza-AUTO LAJZA • Vysoké Mýto","isVatDeductible":null,"engineCapacity":null,"powerKw":null,"ownersCount":0,"ownerType":null,"firstRegistration":null,"firstRegistrationCz":null,"registryData":{"rsvStatus":3,"rsvCheckedAt":"2026-10-05T21:35:17.254Z","vinCheckedAt":"2026-09-07T22:53:51.879Z","notInRegistry":true,"vinBackfillAt":"2026-09-07T16:01:48.847Z"},"condition":null,"color":null,"drivetrain":null,"bodyType":"suv","deduplicationKey":"vin:JSAJTA44V00252629","canonicalModel":"Vitara","createdAt":"2026-09-07 02:59:24.256774+00","updatedAt":"2026-10-09 17:15:27.618+00","isActive":true,"vehicleType":"used","isAuction":false},"marketStat":{"id":"431279b6-2f4c-4ff3-82ce-e9f73ae813fc","brand":"Suzuki","model":"Vitara","fuel":"other","country":"CZ","yearFrom":2008,"yearTo":2019,"mileageFrom":50000,"mileageTo":100000,"avgPrice":330169.9,"medianPrice":362000,"minPrice":119900,"count":10,"computedAt":"2026-10-09 20:45:07.077368+00"},"watchCount":0,"priceDrop":20000,"previousPrice":139900,"display":{"priceBadge":{"kind":"deal","tier":"hot","pct":67},"detailPriceBadge":{"kind":"deal","tier":"hot","pct":67},"registryBadges":[],"flags":{"usImport":{"state":"none"}}}},{"id":"a640c9e4-3089-4e6c-a7f6-66fd455a5fef","listingId":"85dc9d11-2c36-4680-80d2-35e4b24a6736","marketStatId":"d7999eb9-bba1-42d9-b67a-cf7958d788c0","dealScore":0.6545454,"priceDiffPct":65.454544,"flaggedAt":"2026-10-05 17:52:35.228343+00","isPublished":true,"isMarketListing":false,"listing":{"id":"85dc9d11-2c36-4680-80d2-35e4b24a6736","source":"sauto","sourceId":"211221486","url":"https://www.sauto.cz/osobni/detail/renault/twingo/211221486","title":"Renault Twingo","brand":"Renault","model":"Twingo","year":2022,"mileageKm":23000,"priceCzk":190000,"currency":"CZK","fuel":"electric","transmission":null,"description":"","images":["https://d19-a.sdn.cz/d_19/c_img_qG_A/kcKfrMAkFMsuhMJaH9pTQi/eeb1.jpeg"],"location":"Praha, Hlavní město Praha","country":"CZ","vin":"VF1AH000668632023","sellerType":"private","sellerName":null,"isVatDeductible":null,"engineCapacity":null,"powerKw":null,"ownersCount":0,"ownerType":null,"firstRegistration":null,"firstRegistrationCz":null,"registryData":{"rsvStatus":3,"rsvCheckedAt":"2026-10-05T18:03:58.130Z","notInRegistry":true},"condition":null,"color":null,"drivetrain":null,"bodyType":null,"deduplicationKey":"vin:VF1AH000668632023","canonicalModel":"Twingo","createdAt":"2026-10-05 17:52:15.004317+00","updatedAt":"2026-10-09 20:34:49.004+00","isActive":true,"vehicleType":"used","isAuction":false},"marketStat":{"id":"d7999eb9-bba1-42d9-b67a-cf7958d788c0","brand":"Renault","model":"Twingo","fuel":"electric","country":"CZ","yearFrom":2021,"yearTo":2026,"mileageFrom":0,"mileageTo":50000,"avgPrice":505875,"medianPrice":550000,"minPrice":190000,"count":16,"computedAt":"2026-10-09 20:45:07.276269+00"},"watchCount":1,"priceDrop":0,"display":{"priceBadge":{"kind":"deal","tier":"hot","pct":65},"detailPriceBadge":{"kind":"deal","tier":"hot","pct":65},"registryBadges":[],"flags":{"usImport":{"state":"none"}}}}],"total":10476,"page":1,"pageSize":10,"hasMore":true}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/brands":{"get":{"operationId":"listDealBrands","x-mcp-tool":"list_brands","tags":["Deals"],"summary":"Brands with active deals","description":"Brands that currently have published deals, with the number of cards each, most first. Accepts the feed filters so the counts match a filtered feed.","parameters":[{"$ref":"#/components/parameters/brands"},{"$ref":"#/components/parameters/models"},{"$ref":"#/components/parameters/fuels"},{"$ref":"#/components/parameters/vehicleTypes"},{"$ref":"#/components/parameters/bodyTypes"},{"$ref":"#/components/parameters/priceMin"},{"$ref":"#/components/parameters/priceMax"},{"$ref":"#/components/parameters/yearMin"},{"$ref":"#/components/parameters/yearMax"},{"$ref":"#/components/parameters/maxMileage"},{"$ref":"#/components/parameters/minDiscount"},{"$ref":"#/components/parameters/priceDropped"},{"$ref":"#/components/parameters/firstOwner"},{"$ref":"#/components/parameters/czOrigin"},{"$ref":"#/components/parameters/powerMin"},{"$ref":"#/components/parameters/transmission"},{"$ref":"#/components/parameters/damaged"},{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/mode"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"Brands and counts.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"example":[{"brand":"Škoda","count":4889},{"brand":"Volkswagen","count":1946}]}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/models":{"get":{"operationId":"listDealModels","x-mcp-tool":"list_models","tags":["Deals"],"summary":"Models of a brand with active deals","description":"Models of one brand that currently have published deals, with card counts, most first (max 200). Model names are the catalogue canonicals where known.","parameters":[{"name":"brand","in":"query","description":"Brand name, canonical spelling.","required":true,"schema":{"type":"string"},"example":"Škoda"},{"$ref":"#/components/parameters/fuels"},{"$ref":"#/components/parameters/vehicleTypes"},{"$ref":"#/components/parameters/bodyTypes"},{"$ref":"#/components/parameters/priceMin"},{"$ref":"#/components/parameters/priceMax"},{"$ref":"#/components/parameters/yearMin"},{"$ref":"#/components/parameters/yearMax"},{"$ref":"#/components/parameters/maxMileage"},{"$ref":"#/components/parameters/minDiscount"},{"$ref":"#/components/parameters/priceDropped"},{"$ref":"#/components/parameters/firstOwner"},{"$ref":"#/components/parameters/czOrigin"},{"$ref":"#/components/parameters/powerMin"},{"$ref":"#/components/parameters/transmission"},{"$ref":"#/components/parameters/damaged"},{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/mode"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"Models and counts.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"example":[{"model":"Fabia","count":846},{"model":"Kodiaq","count":779}]}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/countries":{"get":{"operationId":"listDealCountries","x-mcp-tool":"list_countries","tags":["Deals"],"summary":"Markets with active deals","description":"Countries that currently have published deals, with card counts. `mode=all` counts the whole market instead.","parameters":[{"$ref":"#/components/parameters/mode"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"Countries and counts.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"country":{"description":"Market the advert belongs to (CZ, SK, PL, HU, RO). Prices are only compared within one country.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"example":[{"country":"CZ","count":17200},{"country":"RO","count":3446}]}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/hot":{"get":{"operationId":"listHotDeals","x-mcp-tool":"list_hot_deals","tags":["Deals"],"summary":"Top deals right now","description":"Up to 15 deals with the biggest discount vs. their segment median, one per car, excluding adverts that would open with a fraud-risk warning.","parameters":[{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"Deals, biggest discount first.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Deal"}},"example":[{"id":"228f2bd8-eed3-4f91-9bbf-bf038ce751f6","listingId":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","marketStatId":"431279b6-2f4c-4ff3-82ce-e9f73ae813fc","dealScore":0.66878456,"priceDiffPct":66.878456,"flaggedAt":"2026-09-12T08:15:09.348Z","isPublished":true,"firstPublishedAt":"2026-09-12T08:15:09.332Z","hiddenByAdmin":false,"hiddenAt":null,"groupKey":"suzuki|vitara|2008|94|6","listingActive":true,"listingDamaged":false,"listingHasVin":true,"listing":{"id":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","source":"tipcars","sourceId":"15780215","url":"https://www.tipcars.com/suzuki-vitara/suv/nafta/suzuki-vitara-1-9-ddis-1-majitel-4x4-servisk-15780215.html","title":"Suzuki Vitara 1,9 DDiS 1.majitel,4x4,servisk","brand":"Suzuki","model":"Vitara","year":2008,"mileageKm":94448,"priceCzk":119900,"currency":"CZK","fuel":"other","transmission":null,"description":"","images":["https://img.tipcars.com/fotky_zdrojove/15780215_1/1748341826/E/suzuki-vitara-1-9-ddis-1-majitel-4x4-servisk.jpg"],"location":"","country":"CZ","vin":"JSAJTA44V00252629","sellerType":"dealer","sellerName":"Tomáš Lajza-AUTO LAJZA • Vysoké Mýto","isVatDeductible":null,"engineCapacity":null,"powerKw":null,"ownersCount":0,"ownerType":null,"firstRegistration":null,"firstRegistrationCz":null,"registryData":{"rsvStatus":3,"rsvCheckedAt":"2026-10-05T21:35:17.254Z","vinCheckedAt":"2026-09-07T22:53:51.879Z","notInRegistry":true,"vinBackfillAt":"2026-09-07T16:01:48.847Z"},"condition":null,"color":null,"drivetrain":null,"bodyType":"suv","deduplicationKey":"vin:JSAJTA44V00252629","canonicalModel":"Vitara","createdAt":"2026-09-07T02:59:24.256Z","updatedAt":"2026-10-09T17:15:27.618Z","lastVerifiedAt":"2026-10-09T10:16:18.870Z","isActive":true,"goneProbeCount":0,"vehicleType":"used","isAuction":false,"feedGroupKey":"suzuki|vitara|2008|94|6","feedIsPrimary":true,"feedIsDeal":true,"feedDealScore":0.66878456},"marketStat":{"id":"431279b6-2f4c-4ff3-82ce-e9f73ae813fc","brand":"Suzuki","model":"Vitara","fuel":"other","country":"CZ","yearFrom":2008,"yearTo":2019,"mileageFrom":50000,"mileageTo":100000,"avgPrice":330169.9,"medianPrice":362000,"minPrice":119900,"count":10,"widenLevel":2,"computedAt":"2026-10-09T20:45:07.077Z"},"watchCount":0,"display":{"priceBadge":{"kind":"deal","tier":"hot","pct":67},"detailPriceBadge":{"kind":"deal","tier":"hot","pct":67},"registryBadges":[],"flags":{"usImport":{"state":"none"}}}},{"id":"a640c9e4-3089-4e6c-a7f6-66fd455a5fef","listingId":"85dc9d11-2c36-4680-80d2-35e4b24a6736","marketStatId":"d7999eb9-bba1-42d9-b67a-cf7958d788c0","dealScore":0.6545454,"priceDiffPct":65.454544,"flaggedAt":"2026-10-05T17:52:35.228Z","isPublished":true,"firstPublishedAt":"2026-10-05T17:52:35.225Z","hiddenByAdmin":false,"hiddenAt":null,"groupKey":"renault|twingo|2022|23|10","listingActive":true,"listingDamaged":false,"listingHasVin":true,"listing":{"id":"85dc9d11-2c36-4680-80d2-35e4b24a6736","source":"sauto","sourceId":"211221486","url":"https://www.sauto.cz/osobni/detail/renault/twingo/211221486","title":"Renault Twingo","brand":"Renault","model":"Twingo","year":2022,"mileageKm":23000,"priceCzk":190000,"currency":"CZK","fuel":"electric","transmission":null,"description":"","images":["https://d19-a.sdn.cz/d_19/c_img_qG_A/kcKfrMAkFMsuhMJaH9pTQi/eeb1.jpeg"],"location":"Praha, Hlavní město Praha","country":"CZ","vin":"VF1AH000668632023","sellerType":"private","sellerName":null,"isVatDeductible":null,"engineCapacity":null,"powerKw":null,"ownersCount":0,"ownerType":null,"firstRegistration":null,"firstRegistrationCz":null,"registryData":{"rsvStatus":3,"rsvCheckedAt":"2026-10-05T18:03:58.130Z","notInRegistry":true},"condition":null,"color":null,"drivetrain":null,"bodyType":null,"deduplicationKey":"vin:VF1AH000668632023","canonicalModel":"Twingo","createdAt":"2026-10-05T17:52:15.004Z","updatedAt":"2026-10-09T20:34:49.004Z","lastVerifiedAt":"2026-10-09T20:30:55.126Z","isActive":true,"goneProbeCount":0,"vehicleType":"used","isAuction":false,"feedGroupKey":"renault|twingo|2022|23|10","feedIsPrimary":true,"feedIsDeal":true,"feedDealScore":0.6545454},"marketStat":{"id":"d7999eb9-bba1-42d9-b67a-cf7958d788c0","brand":"Renault","model":"Twingo","fuel":"electric","country":"CZ","yearFrom":2021,"yearTo":2026,"mileageFrom":0,"mileageTo":50000,"avgPrice":505875,"medianPrice":550000,"minPrice":190000,"count":16,"widenLevel":1,"computedAt":"2026-10-09T20:45:07.276Z"},"watchCount":1,"display":{"priceBadge":{"kind":"deal","tier":"hot","pct":65},"detailPriceBadge":{"kind":"deal","tier":"hot","pct":65},"registryBadges":[],"flags":{"usImport":{"state":"none"}}}}]}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/recently-reduced":{"get":{"operationId":"listRecentlyReducedDeals","x-mcp-tool":"list_recently_reduced","tags":["Deals"],"summary":"Deals whose price was just cut","description":"Up to 10 deals whose latest price is 1–40 % below the previous one, newest cut first, one per car. Each card adds `priceDrop`, `priceDropPct`, `oldPrice` and `droppedAt`.","parameters":[{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"Deals, latest price cut first.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Deal"}},"example":[{"id":"06abbfbe-080b-4c94-9837-ac6cae1c6260","listingId":"f0328a6a-e0eb-44f8-9e19-6b2fb05779fb","marketStatId":"3d6c4593-e7a8-4b41-9566-523636fefc76","dealScore":0.16359833,"priceDiffPct":16.359833,"flaggedAt":"2026-07-15 16:09:51.22363+00","isPublished":true,"listing":{"id":"f0328a6a-e0eb-44f8-9e19-6b2fb05779fb","source":"sauto","sourceId":"210777026","url":"https://www.sauto.cz/osobni/detail/skoda/fabia/210777026","title":"Škoda Fabia, Combi 1,0 TSI / 70 kW Ambition","brand":"Škoda","model":"Fabia","year":2022,"mileageKm":114404,"priceCzk":199900,"fuel":"petrol","transmission":"manual","description":"","images":["https://d19-a.sdn.cz/d_19/c_img_qD_B/kQMlcCt5zmBDp4mHl9HNqFsI/b659.jpeg"],"location":"Chrudim","vin":"TMBJP6NJ7NZ023802","engineCapacity":999,"powerKw":70,"ownersCount":2,"condition":null,"color":null,"drivetrain":null,"sellerType":"dealer","isVatDeductible":null,"deduplicationKey":"vin:TMBJP6NJ7NZ023802","createdAt":"2026-07-15 16:09:07.06413+00","updatedAt":"2026-10-09 20:46:27.396+00","isActive":true},"marketStat":{"id":"3d6c4593-e7a8-4b41-9566-523636fefc76","brand":"Škoda","model":"Fabia","yearFrom":2021,"yearTo":2023,"mileageFrom":100000,"mileageTo":150000,"avgPrice":243374.28,"medianPrice":239000,"minPrice":160000,"count":273,"computedAt":"2026-10-09 20:45:05.783582+00"},"priceDrop":10000,"priceDropPct":4.76,"previousPrice":209900,"watchCount":0,"display":{"priceBadge":{"kind":"deal","tier":"great","pct":16},"detailPriceBadge":{"kind":"deal","tier":"great","pct":16},"registryBadges":[],"flags":{"usImport":{"state":"none"}}}},{"id":"bdcf4ec0-3512-4abc-8840-562bf9dcf79d","listingId":"4299ef64-1b78-49ac-ac4b-89872a67afaf","marketStatId":"e6e7fbc0-9cb0-45f2-a74c-47acf03a812d","dealScore":0.33885217,"priceDiffPct":33.885216,"flaggedAt":"2026-09-17 12:00:09.678466+00","isPublished":true,"listing":{"id":"4299ef64-1b78-49ac-ac4b-89872a67afaf","source":"sauto","sourceId":"211122357","url":"https://www.sauto.cz/osobni/detail/skoda/yeti/211122357","title":"Škoda Yeti, 1.2 TSI 77kw Dsg-Automat","brand":"Škoda","model":"Yeti","year":2013,"mileageKm":192000,"priceCzk":119000,"fuel":"petrol","transmission":"automatic","description":"","images":["https://d19-a.sdn.cz/d_19/c_img_qF_B/k0OqwCKRB7OXguRHy9ov7/79ea.jpeg"],"location":"Bzenec, Hodonín","vin":"TMBJF75L8D6089186","engineCapacity":null,"powerKw":null,"ownersCount":0,"condition":null,"color":null,"drivetrain":null,"sellerType":"private","isVatDeductible":null,"deduplicationKey":"vin:TMBJF75L8D6089186","createdAt":"2026-09-17 11:49:36.681482+00","updatedAt":"2026-10-09 20:49:36.689+00","isActive":true},"marketStat":{"id":"e6e7fbc0-9cb0-45f2-a74c-47acf03a812d","brand":"Škoda","model":"Yeti","yearFrom":2012,"yearTo":2014,"mileageFrom":150000,"mileageTo":200000,"avgPrice":179705.05,"medianPrice":179990,"minPrice":119000,"count":59,"computedAt":"2026-10-09 20:45:06.467307+00"},"priceDrop":6000,"priceDropPct":4.8,"previousPrice":125000,"watchCount":0,"display":{"priceBadge":{"kind":"deal","tier":"hot","pct":34},"detailPriceBadge":{"kind":"deal","tier":"hot","pct":34},"registryBadges":[],"flags":{"usImport":{"state":"none"}}}}]}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/market-trend":{"get":{"operationId":"getMarketTrend","x-mcp-tool":"get_market_trend","tags":["Market"],"summary":"Current median and 7-vs-30-day trend of a model","description":"Median and average asking price, listing count and the 7-day-vs-30-day price change in % for one brand + model (the most populous segment of that model).","parameters":[{"name":"brand","in":"query","description":"Brand name.","required":true,"schema":{"type":"string"},"example":"Škoda"},{"name":"model","in":"query","description":"Model name (catalogue canonical, e.g. \"Octavia\", \"Řada 5\").","required":true,"schema":{"type":"string"},"example":"Octavia"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"The trend.","content":{"application/json":{"schema":{"type":"object","properties":{"medianPrice":{"description":"Median price in CZK.","type":"integer"},"avgPrice":{"description":"Average price of the segment in CZK.","type":"number"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"trendPct":{"description":"Median price change in % over the period (negative = getting cheaper).","type":"number"}}},"example":{"medianPrice":629900,"avgPrice":627021.9,"count":309,"trendPct":-13.64}}}},"400":{"description":"brand or model missing. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"brand and model query parameters are required"}}}},"404":{"description":"No market data for this brand / model. Not recoverable by retrying: there is no such record or not enough data; tell the user.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"No market data found for this brand/model"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/price-trends":{"get":{"operationId":"getPriceHistory","x-mcp-tool":"get_price_history","tags":["Market"],"summary":"90-day daily price history of a model","description":"Daily median and average asking price and listing count over the last 90 days for one brand + model, optionally narrowed to a fuel.","parameters":[{"name":"brand","in":"query","description":"Brand name.","required":true,"schema":{"type":"string"},"example":"Škoda"},{"name":"model","in":"query","description":"Model name.","required":true,"schema":{"type":"string"},"example":"Octavia"},{"name":"fuel","in":"query","description":"Fuel to narrow to (petrol, diesel, hybrid, electric, …).","schema":{"type":"string"},"example":"diesel"},{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"Daily points, oldest first.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"date":{"description":"Day of the data point (YYYY-MM-DD).","type":"string","format":"date"},"medianPrice":{"description":"Median price in CZK.","type":"number"},"avgPrice":{"description":"Average price of the segment in CZK.","type":"number"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"example":[{"date":"2026-07-12","medianPrice":440438.1875,"avgPrice":437110.625,"count":265},{"date":"2026-07-13","medianPrice":448767.09375,"avgPrice":443534.28125,"count":277}]}}},"400":{"description":"brand or model missing. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"brand and model query parameters are required"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/weekly-summary":{"get":{"operationId":"getWeeklySummary","x-mcp-tool":"get_weekly_summary","tags":["Deals"],"summary":"This week at a glance","description":"Number of deals published in the last 7 days, the single best one, and the average amount saved vs. median in CZK.","parameters":[{"$ref":"#/components/parameters/countries"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"The summary.","content":{"application/json":{"schema":{"type":"object","properties":{"newDeals":{"description":"Number of deals published in the last 7 days.","type":"integer"},"bestDeal":{"oneOf":[{"$ref":"#/components/schemas/Deal"},{"type":"null"}],"description":"The single highest-scoring deal published this week."},"avgSavings":{"description":"Average amount below the segment median across this week’s deals, in CZK.","type":"number"}}},"example":{"newDeals":69723,"bestDeal":{"id":"d5c78a44-f59f-49c5-ab0b-7c6486aebe15","listingId":"b22f2e45-059d-4cc4-bf9b-9a4f63fa6516","marketStatId":"47b33cf7-d787-4a3c-8c1f-bc903621da78","dealScore":0.7088235,"priceDiffPct":70.882355,"flaggedAt":"2026-10-07T11:16:08.841Z","isPublished":true,"firstPublishedAt":"2026-10-07T11:16:08.838Z","hiddenByAdmin":false,"hiddenAt":null,"groupKey":"audi|a8|2011|295|3","listingActive":true,"listingDamaged":true,"listingHasVin":false,"listing":{"id":"b22f2e45-059d-4cc4-bf9b-9a4f63fa6516","source":"otomoto-pl","sourceId":"6151001544","url":"https://www.otomoto.pl/osobowe/oferta/audi-a8-ID6IgYuk.html","title":"Audi A8 3.0 TDI","brand":"Audi","model":"A8","year":2011,"mileageKm":295000,"priceCzk":57915,"currency":"PLN","fuel":"diesel","transmission":"automatic","description":"Powypadkowy , na części , kompletny","images":["https://ireland.apollo.olxcdn.com/v1/files/rhcd2n8kuk4r3-OTOMOTOPL/image;s=640x480"],"location":"Lipnica, Pomorskie","country":"PL","vin":null,"sellerType":"dealer","sellerName":null,"isVatDeductible":null,"engineCapacity":2967,"powerKw":150,"ownersCount":null,"ownerType":null,"firstRegistration":null,"firstRegistrationCz":null,"registryData":null,"condition":"damaged","color":null,"drivetrain":null,"bodyType":null,"deduplicationKey":"combo:audi:a8:2011:295","canonicalModel":"A8","createdAt":"2026-10-07T11:15:37.306Z","updatedAt":"2026-10-09T19:00:36.555Z","lastVerifiedAt":null,"isActive":true,"goneProbeCount":0,"vehicleType":"used","isAuction":false,"feedGroupKey":"audi|a8|2011|295|3","feedIsPrimary":true,"feedIsDeal":true,"feedDealScore":0.7088235},"marketStat":{"id":"47b33cf7-d787-4a3c-8c1f-bc903621da78","brand":"Audi","model":"A8","fuel":"diesel","country":"PL","yearFrom":2010,"yearTo":2012,"mileageFrom":200000,"mileageTo":999999999,"avgPrice":316461.6,"medianPrice":300280.5,"minPrice":233415,"count":10,"widenLevel":0,"computedAt":"2026-10-09T20:45:06.467Z"}},"avgSavings":23.35}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/valuation":{"get":{"operationId":"estimateValuation","x-mcp-tool":"estimate_valuation","tags":["Market"],"summary":"Fair price range of a specific car","description":"Min / median / max asking price of comparable active listings (same brand, model, fuel, ±1 model year, same mileage band) in CZK, with the sample size. Statistical, not an appraisal.","parameters":[{"name":"brand","in":"query","description":"Brand name.","required":true,"schema":{"type":"string"},"example":"Škoda"},{"name":"model","in":"query","description":"Model name.","required":true,"schema":{"type":"string"},"example":"Octavia"},{"name":"year","in":"query","description":"Model year.","required":true,"schema":{"type":"integer","minimum":1900},"example":2019},{"name":"fuel","in":"query","description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng.","required":true,"schema":{"type":"string"},"example":"diesel"},{"name":"mileage","in":"query","description":"Odometer reading in km (0–2 000 000).","required":true,"schema":{"type":"integer","minimum":0,"maximum":2000000},"example":120000},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"The estimate.","content":{"application/json":{"schema":{"type":"object","properties":{"estimatedMin":{"description":"Lower bound of the fair price range in CZK (25th percentile of comparable listings).","type":"integer"},"estimatedMedian":{"description":"Median asking price of comparable listings in CZK — the fair-value estimate.","type":"integer"},"estimatedMax":{"description":"Upper bound of the fair price range in CZK (75th percentile).","type":"integer"},"sampleCount":{"description":"How many comparable listings the estimate is based on.","type":"integer"},"segment":{"description":"The year and mileage band of the comparable listings used.","type":"object","properties":{"yearFrom":{"description":"First model year of the segment.","type":"integer"},"yearTo":{"description":"Last model year of the segment.","type":"integer"},"mileageFrom":{"description":"Lower bound of the segment mileage band in km.","type":"integer"},"mileageTo":{"description":"Upper bound of the segment mileage band in km.","type":"integer"}}}}},"example":{"estimatedMin":170591,"estimatedMedian":379900,"estimatedMax":636000,"sampleCount":676,"segment":{"yearFrom":2019,"yearTo":2021,"mileageFrom":100000,"mileageTo":150000}}}}},"400":{"description":"A parameter is missing or out of range; `code` names which. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."},"code":{"type":"string","enum":["mileage_out_of_range","year_out_of_range"],"description":"Present for range errors."}},"required":["error"]},"example":{"error":"mileage must be between 0 and 2000000 km","code":"mileage_out_of_range"}}}},"404":{"description":"Fewer than 6 comparable listings — no estimate. Not recoverable by retrying: there is no such record or not enough data; tell the user.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"No market data found for this combination"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/deals/{id}":{"get":{"operationId":"getDeal","x-mcp-tool":"get_deal","tags":["Deals"],"summary":"One deal in full","description":"The deal card plus price history (merged across relists of the same VIN), segment statistics, a heuristic price forecast, the official registry dossier when the VIN is known, how many users watch it and the UI judgment flags. Ex-deals keep their row, so shared links keep working.","parameters":[{"name":"id","in":"path","description":"Deal id.","required":true,"schema":{"type":"string","format":"uuid"},"example":"228f2bd8-eed3-4f91-9bbf-bf038ce751f6"}],"responses":{"200":{"description":"The deal.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Deal"},{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"marketStatId":{"description":"The market segment (market_stats row) the listing was scored against; null for an unscored listing.","type":"string"},"dealScore":{"description":"How far below its segment median the listing is priced, as a fraction (0.25 = 25 % below). 0 for market-tail rows.","type":"number"},"priceDiffPct":{"description":"Percent below the segment median price. Positive = cheaper than comparable cars; a published deal is ≥ 12 (used) / ≥ 5 (new).","type":"number"},"flaggedAt":{"description":"When the listing was last promoted to a published deal.","type":"string","format":"date-time"},"isPublished":{"description":"true = a deal (priced 12 %+ below its segment median and not suppressed); false = a rated listing in the market tail.","type":"boolean"},"firstPublishedAt":{"description":"When the listing first became a published deal; null if it never was.","type":"string","format":"date-time"},"hiddenByAdmin":{"description":"Manually hidden from the feed.","type":"boolean"},"hiddenAt":{"type":"null"},"groupKey":{"description":"Duplicate-group key: cross-posts of the same car share it and the feed shows one card per group.","type":"string"},"listingActive":{"description":"The advert was still online at the last check.","type":"boolean"},"listingDamaged":{"description":"The advert is marked as a damaged / crashed car.","type":"boolean"},"listingHasVin":{"description":"The advert publishes a usable 17-character VIN.","type":"boolean"},"isMarketListing":{"description":"true for a market-tail row (rated against its segment but not a deal).","type":"boolean"},"listing":{"$ref":"#/components/schemas/Listing"},"marketStat":{"allOf":[{"$ref":"#/components/schemas/MarketStat"}],"description":"The comparable-cars segment the price is judged against."},"priceHistory":{"description":"Price changes of this advert (and of relists of the same car), oldest first.","type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"recordedAt":{"type":"string","format":"date-time"}}}},"relist":{"description":"When the same car (same VIN) was advertised before: the earlier adverts and their prices; null otherwise.","type":"null"},"watchCount":{"description":"How many AutoSignal users watch this listing.","type":"integer"},"prediction":{"description":"Heuristic price-direction forecast for this advert with a Czech reason.","type":"object","properties":{"direction":{"type":"string"},"confidence":{"type":"string"},"reason":{"type":"string"}}},"registryDossier":{"oneOf":[{"$ref":"#/components/schemas/RegistryDossier"},{"type":"null"}],"description":"Official Czech registry (RSV) history for the VIN: owners, inspections, import origin; null when the VIN is unknown or missing."},"registryVinMismatch":{"description":"true when the registry names a different make than the advert — a red flag.","type":"boolean"},"display":{"description":"Pre-computed presentation of the judgment (price badge tier, registry badges, warning flags) — what the AutoSignal UI shows.","type":"object","additionalProperties":true}}}],"description":"A deal with everything the detail page shows."},"example":{"id":"228f2bd8-eed3-4f91-9bbf-bf038ce751f6","listingId":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","marketStatId":"431279b6-2f4c-4ff3-82ce-e9f73ae813fc","dealScore":0.66878456,"priceDiffPct":66.878456,"flaggedAt":"2026-09-12T08:15:09.348Z","isPublished":true,"firstPublishedAt":"2026-09-12T08:15:09.332Z","hiddenByAdmin":false,"hiddenAt":null,"groupKey":"suzuki|vitara|2008|94|6","listingActive":true,"listingDamaged":false,"listingHasVin":true,"isMarketListing":false,"listing":{"id":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","source":"tipcars","sourceId":"15780215","url":"https://www.tipcars.com/suzuki-vitara/suv/nafta/suzuki-vitara-1-9-ddis-1-majitel-4x4-servisk-15780215.html","title":"Suzuki Vitara 1,9 DDiS 1.majitel,4x4,servisk","brand":"Suzuki","model":"Vitara","year":2008,"mileageKm":94448,"priceCzk":119900,"currency":"CZK","fuel":"other","transmission":null,"description":"","images":["https://img.tipcars.com/fotky_zdrojove/15780215_1/1748341826/E/suzuki-vitara-1-9-ddis-1-majitel-4x4-servisk.jpg"],"location":"","country":"CZ","vin":"JSAJTA44V00252629","sellerType":"dealer","sellerName":"Tomáš Lajza-AUTO LAJZA • Vysoké Mýto","isVatDeductible":null,"engineCapacity":null,"powerKw":null,"ownersCount":0,"ownerType":null,"firstRegistration":null,"firstRegistrationCz":null,"registryData":{"rsvStatus":3,"rsvCheckedAt":"2026-10-05T21:35:17.254Z","vinCheckedAt":"2026-09-07T22:53:51.879Z","notInRegistry":true,"vinBackfillAt":"2026-09-07T16:01:48.847Z"},"condition":null,"color":null,"drivetrain":null,"bodyType":"suv","deduplicationKey":"vin:JSAJTA44V00252629","canonicalModel":"Vitara","createdAt":"2026-09-07T02:59:24.256Z","updatedAt":"2026-10-09T17:15:27.618Z","lastVerifiedAt":"2026-10-09T10:16:18.870Z","isActive":true,"goneProbeCount":0,"vehicleType":"used","isAuction":false,"feedGroupKey":"suzuki|vitara|2008|94|6","feedIsPrimary":true,"feedIsDeal":true,"feedDealScore":0.66878456},"marketStat":{"id":"431279b6-2f4c-4ff3-82ce-e9f73ae813fc","brand":"Suzuki","model":"Vitara","fuel":"other","country":"CZ","yearFrom":2008,"yearTo":2019,"mileageFrom":50000,"mileageTo":100000,"avgPrice":330169.9,"medianPrice":362000,"minPrice":119900,"count":10,"widenLevel":2,"computedAt":"2026-10-09T20:45:07.077Z"},"priceHistory":[{"id":"cf82c62f-5ef0-4e48-a0ba-7998b321a644","listingId":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","priceCzk":139900,"recordedAt":"2026-09-07T02:59:24.268Z"},{"id":"cecb47e9-2ed3-4de6-b291-6716d53d0db9","listingId":"44b6ed8b-0abd-461b-858c-b4f6381c96c2","priceCzk":119900,"recordedAt":"2026-09-10T18:27:31.803Z"}],"relist":null,"watchCount":0,"prediction":{"direction":"down","confidence":"medium","reason":"Inzerát je starší než 30 dní — prodejce pravděpodobně sníží cenu"},"registryDossier":null,"registryVinMismatch":false,"display":{"priceBadge":{"kind":"deal","tier":"hot","pct":67},"detailPriceBadge":{"kind":"deal","tier":"hot","pct":67},"registryBadges":[],"flags":{"scam":[{"id":"suspiciouslyLowPrice","severity":"danger"}],"usImport":{"state":"none"}}}}}}},"404":{"description":"Unknown deal id (or not a UUID). Not recoverable by retrying: there is no such record or not enough data; tell the user.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"Deal not found"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/seo-stats/brand/{slug}":{"get":{"operationId":"getBrandPrices","tags":["Prices"],"summary":"Price overview of a brand","description":"Listing count, median and quartile prices in CZK, average days on market, 30-day change, deal count, the most-listed models and the 90-day median trend for one brand. An unknown brand answers 200 with zero counts.","parameters":[{"name":"slug","in":"path","description":"Brand slug (lower-case ASCII, e.g. skoda, mercedes-benz).","required":true,"schema":{"type":"string"},"example":"skoda"},{"$ref":"#/components/parameters/country"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"The brand overview.","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"},"p25":{"description":"25th percentile price in CZK (lower quartile).","type":"integer"},"p75":{"description":"75th percentile price in CZK (upper quartile).","type":"integer"},"min":{"description":"Lowest asking price in CZK among the listings counted.","type":"integer"},"max":{"description":"Highest asking price in CZK among the listings counted.","type":"integer"},"avgDaysOnMarket":{"description":"Average number of days an advert stays online.","type":"integer"},"change30dPct":{"description":"Median price change over the last 30 days in %.","type":"number"},"dealCount":{"description":"Published deals currently available for this brand / model.","type":"integer"},"topModels":{"description":"The most-listed models with count and median price.","type":"array","items":{"type":"object","properties":{"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"}}}},"priceTrend90d":{"description":"Daily median price over the last 90 days.","type":"array","items":{"type":"object","properties":{"date":{"description":"Day of the data point (YYYY-MM-DD).","type":"string","format":"date"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}}}},"example":{"countries":["CZ"],"brand":"Škoda","count":63709,"median":518000,"p25":339990,"p75":738000,"min":50000,"max":1793400,"avgDaysOnMarket":70,"change30dPct":1.5,"dealCount":4936,"topModels":[{"model":"Octavia","count":17967,"median":438000},{"model":"Kodiaq","count":7992,"median":979800}],"priceTrend90d":[{"date":"2026-07-12","medianPrice":714818,"count":58310},{"date":"2026-07-13","medianPrice":714582,"count":57431}]}}}},"400":{"description":"Missing slug. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"slug is required"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/seo-stats/model/{brandSlug}/{modelSlug}":{"get":{"operationId":"getModelPrices","tags":["Prices"],"summary":"Price overview of a model","description":"Listing count, median / quartile / min / max price in CZK, median mileage, 30-day change, a per-model-year breakdown, fuel split and 90-day trend for one brand + model. An unknown model answers 200 with zero counts.","parameters":[{"name":"brandSlug","in":"path","description":"Brand slug.","required":true,"schema":{"type":"string"},"example":"skoda"},{"name":"modelSlug","in":"path","description":"Model slug (e.g. octavia, rada-5, trida-e).","required":true,"schema":{"type":"string"},"example":"octavia"},{"$ref":"#/components/parameters/country"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"The model overview.","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"},"p25":{"description":"25th percentile price in CZK (lower quartile).","type":"integer"},"p75":{"description":"75th percentile price in CZK (upper quartile).","type":"integer"},"min":{"description":"Lowest asking price in CZK among the listings counted.","type":"integer"},"max":{"description":"Highest asking price in CZK among the listings counted.","type":"integer"},"medianMileageKm":{"description":"Median odometer reading in km.","type":"integer"},"change30dPct":{"description":"Median price change over the last 30 days in %.","type":"number"},"byYear":{"description":"Breakdown by model year.","type":"array","items":{"type":"object","properties":{"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"},"medianMileageKm":{"description":"Median odometer reading in km.","type":"integer"}}}},"byFuel":{"description":"Breakdown by fuel.","type":"array","items":{"type":"object","properties":{"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"}}}},"priceTrend90d":{"description":"Daily median price over the last 90 days.","type":"array","items":{"type":"object","properties":{"date":{"description":"Day of the data point (YYYY-MM-DD).","type":"string","format":"date"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"deals":{"description":"Published deals of the class.","type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"dealScore":{"description":"How far below its segment median the listing is priced, as a fraction (0.25 = 25 % below). 0 for market-tail rows.","type":"number"},"priceDiffPct":{"description":"Percent below the segment median price. Positive = cheaper than comparable cars; a published deal is ≥ 12 (used) / ≥ 5 (new).","type":"number"},"title":{"description":"Advert title as published by the seller.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"mileageKm":{"description":"Odometer reading in kilometres.","type":"integer"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"url":{"description":"Link to the original advert.","type":"string"},"images":{"description":"Photo URLs on the source site.","type":"array","items":{"type":"string"}}}}}}},"example":{"countries":["CZ"],"brand":"Škoda","model":"Octavia","count":17967,"median":438000,"p25":259000,"p75":678000,"min":50000,"max":1297700,"medianMileageKm":95071,"change30dPct":-3.9,"byYear":[{"year":2027,"count":43,"median":938800,"medianMileageKm":0},{"year":2026,"count":1812,"median":802464,"medianMileageKm":0}],"byFuel":[{"fuel":"diesel","count":8865,"median":370000},{"fuel":"petrol","count":7426,"median":579900}],"priceTrend90d":[{"date":"2026-07-12","medianPrice":530064,"count":18760},{"date":"2026-07-13","medianPrice":529960,"count":18455}],"deals":[{"id":"d9b9e150-8444-428d-b62f-b52cd938c94f","listingId":"c6ce2e03-fe6a-43dd-8bc5-652bb38f9843","dealScore":0.49748743,"priceDiffPct":49.748745,"title":"Škoda Octavia 1,6 i 75KW, ČR, KLIMATIZACE.","year":2009,"mileageKm":176886,"priceCzk":55000,"fuel":"other","url":"https://www.tipcars.com/skoda-octavia/liftback/benzin/skoda-octavia-1-6-i-75kw-cr-klimatizace-8910012.html","images":["https://img.tipcars.com/fotky_zdrojove/08910012_8/1770982214/E/skoda-octavia-1-6-i-75kw-cr-klimatizace.jpg"]},{"id":"48623b32-78a9-4ee3-b82e-df80e4512e9d","listingId":"b91de67e-c30b-421d-a722-c5b93c762b3a","dealScore":0.47826087,"priceDiffPct":47.826088,"title":"Škoda Octavia, 1.9 TDi","year":2010,"mileageKm":86727,"priceCzk":120000,"fuel":"diesel","url":"https://www.sauto.cz/osobni/detail/skoda/octavia/211250925","images":["https://d19-a.sdn.cz/d_19/c_img_qG_A/nCR9NVflLrfprhXSICCKxe/f9a6.jpeg"]}]}}}},"400":{"description":"Missing or malformed slugs. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"brand and model slugs required"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/seo-stats/year/{brandSlug}/{modelSlug}/{year}":{"get":{"operationId":"getModelYearPrices","tags":["Prices"],"summary":"Price overview of a model year","description":"Count, median and quartile prices in CZK, median mileage, breakdowns by mileage band and fuel, and the 90-day trend for one brand + model + model year.","parameters":[{"name":"brandSlug","in":"path","description":"Brand slug.","required":true,"schema":{"type":"string"},"example":"skoda"},{"name":"modelSlug","in":"path","description":"Model slug.","required":true,"schema":{"type":"string"},"example":"octavia"},{"name":"year","in":"path","description":"Model year, 1990–2100.","required":true,"schema":{"type":"integer","minimum":1990,"maximum":2100},"example":2019},{"$ref":"#/components/parameters/country"},{"$ref":"#/components/parameters/vehicleClass"}],"responses":{"200":{"description":"The model-year overview.","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"},"p25":{"description":"25th percentile price in CZK (lower quartile).","type":"integer"},"p75":{"description":"75th percentile price in CZK (upper quartile).","type":"integer"},"medianMileageKm":{"description":"Median odometer reading in km.","type":"integer"},"byMileage":{"description":"Breakdown by mileage band.","type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"}}}},"byFuel":{"description":"Breakdown by fuel.","type":"array","items":{"type":"object","properties":{"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"median":{"description":"Median asking price in CZK.","type":"integer"}}}},"priceTrend90d":{"description":"Daily median price over the last 90 days.","type":"array","items":{"type":"object","properties":{"date":{"description":"Day of the data point (YYYY-MM-DD).","type":"string","format":"date"},"medianPrice":{"description":"Median price in CZK.","type":"integer"}}}},"deals":{"description":"Published deals of the class.","type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"dealScore":{"description":"How far below its segment median the listing is priced, as a fraction (0.25 = 25 % below). 0 for market-tail rows.","type":"number"},"priceDiffPct":{"description":"Percent below the segment median price. Positive = cheaper than comparable cars; a published deal is ≥ 12 (used) / ≥ 5 (new).","type":"number"},"title":{"description":"Advert title as published by the seller.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"mileageKm":{"description":"Odometer reading in kilometres.","type":"integer"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"url":{"description":"Link to the original advert.","type":"string"},"images":{"description":"Photo URLs on the source site.","type":"array","items":{"type":"string"}}}}}}},"example":{"countries":["CZ"],"brand":"Škoda","model":"Octavia","year":2019,"count":662,"median":299000,"p25":250000,"p75":359000,"medianMileageKm":162075,"byMileage":[{"bucket":"<50k","count":10,"median":379900},{"bucket":"50-100k","count":69,"median":360000}],"byFuel":[{"fuel":"diesel","count":345,"median":290000},{"fuel":"petrol","count":232,"median":319888}],"priceTrend90d":[{"date":"2026-07-12","medianPrice":530064},{"date":"2026-07-13","medianPrice":529960}],"deals":[{"id":"5085e354-ca1f-4516-8570-ddc79cfedc0a","listingId":"097a6dbf-7343-49a3-aadb-272a284779f9","dealScore":0.36805335,"priceDiffPct":36.805336,"title":"Škoda Octavia, 1.5G-TEC 96kW DSG Style","year":2019,"mileageKm":171663,"priceCzk":199000,"fuel":"petrol","url":"https://www.sauto.cz/osobni/detail/skoda/octavia/211245711","images":["https://d19-a.sdn.cz/d_19/c_img_qG_A/kcKfrMAkFMsuhbFMIBwH10/30a2.jpeg"]},{"id":"f44cff03-b45b-4564-b3e9-6ff89ac71e4d","listingId":"ac0f52fc-834a-43dc-ae26-374e023e9d2f","dealScore":0.36571229,"priceDiffPct":36.571228,"title":"Škoda Octavia, 1.5TSi 96kw CNG Automat DPH ČR","year":2019,"mileageKm":196905,"priceCzk":199800,"fuel":"petrol","url":"https://www.sauto.cz/osobni/detail/skoda/octavia/210684812","images":["https://d19-a.sdn.cz/d_19/c_img_qC_C/nO2CysqjGrDPliFSSVHDiPcg/048d.jpeg"]}]}}}},"400":{"description":"Missing slugs or a year outside 1990–2100. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"brand slug, model slug, year required"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/market-data/overview":{"get":{"operationId":"getMarketOverview","x-mcp-tool":"get_market_overview","tags":["Market"],"summary":"Market snapshot of a country","description":"Headline pulse, price direction (30 d and 6 m), a buyer's/seller's-market verdict, breakdowns by fuel, body and brand, deal hotspots, the 90-day trend, supply and freshness, oversupply and fast-mover signals, plus the latest month of new-car registrations. Heavy; cached.","parameters":[{"$ref":"#/components/parameters/country"}],"responses":{"200":{"description":"The snapshot.","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}},"pulse":{"description":"Headline figures: active listings, overall median, average deal discount.","type":"object","properties":{"totalActiveListings":{"description":"Active adverts in the market right now.","type":"integer"},"overallMedianPrice":{"description":"Median asking price across the whole market in CZK.","type":"integer"},"avgDealDiscount":{"description":"Average % below median of the currently published deals.","type":"number"},"lastUpdated":{"description":"When the snapshot was computed.","type":"string","format":"date-time"}}},"priceDirection":{"description":"Where prices are heading: 30-day and 6-month change of the market median.","type":"object","properties":{"change30dPct":{"description":"Median price change over the last 30 days in %.","type":"number"},"currentMedian":{"type":"integer"},"previousMedian":{"type":"integer"},"change6mPct":{"type":"number"}}},"verdict":{"description":"Heuristic buyer's/seller's market call with the signals behind it.","type":"object","properties":{"mood":{"description":"buyer, seller or neutral.","type":"string"},"score":{"type":"integer"},"signals":{"type":"object","properties":{"price30dChangePct":{"type":"number"},"supplyDelta":{"type":"integer"},"avgDaysOnMarket":{"description":"Average number of days an advert stays online.","type":"integer"}}}}},"fuelBreakdown":{"description":"Share, median price and 30-day trend per fuel.","type":"array","items":{"type":"object","properties":{"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"pct":{"type":"number"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"trend30dPct":{"type":["number","null"]}}}},"topBrands":{"description":"Most-listed brands with median price and 30-day trend.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"trend30dPct":{"type":"number"}}}},"dealHotspots":{"description":"Brand + model combinations with the most / deepest deals right now.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"avgDiscount":{"type":"number"},"dealCount":{"description":"Published deals currently available for this brand / model.","type":"integer"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"yearMin":{"type":"integer"},"yearMax":{"type":"integer"}}}},"priceTrend90d":{"description":"Daily median price over the last 90 days.","type":"array","items":{"type":"object","properties":{"date":{"description":"Day of the data point (YYYY-MM-DD).","type":"string","format":"date"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"supply":{"description":"New vs. removed adverts in the last 7 days and average days on market.","type":"object","properties":{"newListings7d":{"type":"integer"},"removedListings7d":{"type":"integer"},"avgDaysOnMarket":{"description":"Average number of days an advert stays online.","type":"integer"}}},"monthlyPrices":{"description":"Monthly median price history.","type":"array","items":{"type":"object","properties":{"month":{"type":"string"},"medianPrice":{"description":"Median price in CZK.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"bodyTypeBreakdown":{"description":"Share and median price per body type.","type":"array","items":{"type":"object","properties":{"bodyType":{"description":"Body: kombi, sedan, hatchback, suv, mpv, coupe, cabrio, pickup, van, …","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"pct":{"type":"number"},"medianPrice":{"description":"Median price in CZK.","type":"integer"}}}},"importedDelta":{"description":"Models where imported cars are priced very differently from Czech-origin ones.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"czMedian":{"type":"integer"},"importedMedian":{"type":"integer"},"czCount":{"type":"integer"},"importedCount":{"type":"integer"},"deltaPct":{"type":"number"}}}},"sellerSplit":{"description":"Dealer vs. private adverts with median prices.","type":"array","items":{"type":"object","properties":{"sellerType":{"description":"dealer or private.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"medianPrice":{"description":"Median price in CZK.","type":"integer"}}}},"singleOwnerPremium":{"description":"How much more one-owner cars cost than multi-owner ones, per brand.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"oneOwnerMedian":{"type":"integer"},"multiOwnerMedian":{"type":"integer"},"premiumPct":{"type":"number"},"oneOwnerCount":{"type":"integer"},"multiOwnerCount":{"type":"integer"}}}},"freshness":{"description":"How many active adverts are fresh (<7 d), mid (7–30 d) or stale (>30 d).","type":"object","properties":{"fresh":{"type":"integer"},"mid":{"type":"integer"},"stale":{"type":"integer"},"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"}}},"oversupply":{"description":"Brand + fuel combinations whose inventory grew most while prices fell.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"currentCount":{"type":"integer"},"pastCount":{"type":"integer"},"currentMedian":{"type":"integer"},"pastMedian":{"type":"integer"},"inventoryChangePct":{"description":"Change of active inventory vs. the prior month in %.","type":"number"},"priceChangePct":{"type":"number"}}}},"fastMovers":{"description":"Models whose adverts disappear fastest (likely sold quickly).","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"removedCount":{"type":"integer"},"avgDaysToDeactivate":{"type":"number"},"medianPrice":{"description":"Median price in CZK.","type":"integer"}}}},"registrations":{"description":"New-car registrations of the latest month (SDA-CIA data).","type":["object","null"],"properties":{"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"month":{"type":"integer"},"totals":{"description":"Units registered in the month, the prior-year month and the year-over-year change.","type":"object","properties":{"units":{"description":"Vehicles registered.","type":"integer"},"unitsPriorYear":{"description":"Vehicles registered in the same month a year earlier.","type":"integer"},"yoyPct":{"description":"Year-over-year change in %.","type":"number"}}},"topBrands":{"description":"Most-listed brands with median price and 30-day trend.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"brandRaw":{"type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"null"},"units":{"description":"Vehicles registered.","type":"integer"},"sharePct":{"description":"Share of all registrations in the month, %.","type":"number"},"rank":{"type":"integer"},"unitsPriorYear":{"description":"Vehicles registered in the same month a year earlier.","type":"integer"},"sharePctPriorYear":{"type":"number"},"yoyPct":{"description":"Year-over-year change in %.","type":"number"}}}},"topModels":{"description":"The most-listed models with count and median price.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"brandRaw":{"type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"units":{"description":"Vehicles registered.","type":"integer"},"sharePct":{"description":"Share of all registrations in the month, %.","type":"number"},"rank":{"type":"integer"},"unitsPriorYear":{"description":"Vehicles registered in the same month a year earlier.","type":"integer"},"sharePctPriorYear":{"type":"number"},"yoyPct":{"description":"Year-over-year change in %.","type":"number"}}}}}}}},"example":{"countries":["CZ"],"pulse":{"totalActiveListings":247703,"overallMedianPrice":548064,"avgDealDiscount":21.91,"lastUpdated":"2026-10-09T20:52:00.364Z"},"priceDirection":{"change30dPct":-4.6,"currentMedian":979061,"previousMedian":1025898,"change6mPct":-43.2},"verdict":{"mood":"buyer","score":1,"signals":{"price30dChangePct":-4.6,"supplyDelta":-8748,"avgDaysOnMarket":68}},"fuelBreakdown":[{"fuel":"petrol","count":117047,"pct":47.3,"medianPrice":519900,"trend30dPct":-5.4},{"fuel":"diesel","count":78749,"pct":31.8,"medianPrice":510000,"trend30dPct":-14.9}],"topBrands":[{"brand":"Škoda","count":63638,"medianPrice":517900,"trend30dPct":1.5},{"brand":"Volkswagen","count":24252,"medianPrice":449000,"trend30dPct":-6.3}],"dealHotspots":[{"brand":"Ford","model":"Tourneo Courier","avgDiscount":54.43,"dealCount":4,"medianPrice":194900,"yearMin":2015,"yearMax":2016},{"brand":"Nissan","model":"LEAF","avgDiscount":42.13,"dealCount":3,"medianPrice":340000,"yearMin":2017,"yearMax":2024}],"priceTrend90d":[{"date":"2026-07-12","medianPrice":1001805,"count":197837},{"date":"2026-07-13","medianPrice":1001705,"count":196052}],"supply":{"newListings7d":27623,"removedListings7d":36371,"avgDaysOnMarket":68},"monthlyPrices":[{"month":"2026-04","medianPrice":964604,"count":3174500},{"month":"2026-05","medianPrice":993489,"count":4506937}],"bodyTypeBreakdown":[{"bodyType":"suv","count":40786,"pct":40.8,"medianPrice":650000},{"bodyType":"combi","count":23646,"pct":23.7,"medianPrice":379000}],"importedDelta":[{"brand":"Mercedes-Benz","model":"Třída CLK","czMedian":1924832,"importedMedian":125135,"czCount":54,"importedCount":43,"deltaPct":93.5},{"brand":"Mitsubishi","model":"Lancer","czMedian":268724,"importedMedian":116295,"czCount":33,"importedCount":62,"deltaPct":56.7}],"sellerSplit":[{"sellerType":"dealer","count":232510,"medianPrice":559900},{"sellerType":"private","count":15193,"medianPrice":289000}],"singleOwnerPremium":[{"brand":"Chevrolet","oneOwnerMedian":950000,"multiOwnerMedian":149000,"premiumPct":537.6,"oneOwnerCount":93,"multiOwnerCount":115},{"brand":"Chrysler","oneOwnerMedian":532400,"multiOwnerMedian":185130,"premiumPct":187.6,"oneOwnerCount":26,"multiOwnerCount":33}],"freshness":{"fresh":87929,"mid":82965,"stale":76809,"total":247703},"oversupply":[{"brand":"Mercedes-Benz","fuel":"petrol","currentCount":3894,"pastCount":75,"currentMedian":990000,"pastMedian":1856380,"inventoryChangePct":5092,"priceChangePct":-46.7},{"brand":"Audi","fuel":"petrol","currentCount":2232,"pastCount":43,"currentMedian":750000,"pastMedian":1410200,"inventoryChangePct":5090.7,"priceChangePct":-46.8}],"fastMovers":[{"brand":"Kia","model":"Carnival","removedCount":20,"avgDaysToDeactivate":5.1,"medianPrice":1048500},{"brand":"Peugeot","model":"807","removedCount":31,"avgDaysToDeactivate":6.3,"medianPrice":69000}],"registrations":{"year":2026,"month":9,"totals":{"units":19095,"unitsPriorYear":21370,"yoyPct":-10.6},"topBrands":[{"brand":"skoda","brandRaw":"Škoda","model":null,"units":7006,"sharePct":36.69,"rank":1,"unitsPriorYear":8118,"sharePctPriorYear":37.99,"yoyPct":86.3}],"topModels":[{"brand":"skoda","brandRaw":"Škoda","model":"Octavia","units":1574,"sharePct":8.24,"rank":1,"unitsPriorYear":1791,"sharePctPriorYear":8.38,"yoyPct":87.88}]}}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/market-data/registry":{"get":{"operationId":"getRegistryFleet","tags":["Market"],"summary":"The standing Czech vehicle fleet","description":"The Czech vehicle stock from the monthly official-registry snapshot: fleet size, vehicles per make and model, age distribution, fuel mix, imports and the biggest fleets. `available: false` until the first snapshot is loaded.","responses":{"200":{"description":"The fleet statistics.","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"description":"false when the registry snapshot has not been loaded yet.","type":"boolean"},"snapshotDate":{"description":"Date of the monthly registry snapshot the data comes from.","type":"string","format":"date"},"fleetSummary":{"description":"Size of the standing Czech vehicle fleet from the registry.","type":"object","properties":{"operated":{"type":"integer"},"totalAll":{"type":"integer"},"snapshotDate":{"description":"Date of the monthly registry snapshot the data comes from.","type":"string","format":"date"},"avgSourceRows":{"type":"integer"},"passengerOperated":{"type":"integer"}}},"brandCounts":{"description":"Registered vehicles per make in the Czech fleet.","type":"object","additionalProperties":{"type":"integer"}},"importStats":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"array","items":{"type":"object","properties":{"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"share":{"type":"number"}}}},"byYear":{"description":"Breakdown by model year.","type":"object","properties":{"2026":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"USA":{"type":"integer"},"Belgie":{"type":"integer"},"Polsko":{"type":"integer"},"Dánsko":{"type":"integer"},"Francie":{"type":"integer"},"Itálie":{"type":"integer"},"Německo":{"type":"integer"},"Rakousko":{"type":"integer"},"Slovensko":{"type":"integer"},"Švédsko":{"type":"integer"},"Nizozemsko":{"type":"integer"},"Švýcarsko":{"type":"integer"}}}}},"2027":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Řecko":{"type":"integer"},"Německo":{"type":"integer"}}}}},"2029":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Maďarsko":{"type":"integer"},"Nizozemsko":{"type":"integer"}}}}},"2034":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Německo":{"type":"integer"}}}}},"2044":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Itálie":{"type":"integer"},"Německo":{"type":"integer"},"Nizozemsko":{"type":"integer"}}}}},"2047":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Dánsko":{"type":"integer"},"Německo":{"type":"integer"}}}}},"2053":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Německo":{"type":"integer"}}}}},"2054":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Německo":{"type":"integer"}}}}},"2060":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Rakousko":{"type":"integer"}}}}},"2084":{"type":"object","properties":{"total":{"description":"Total number of cards matching the filters (one card per duplicate group).","type":"integer"},"countries":{"type":"object","properties":{"Polsko":{"type":"integer"}}}}}}}}},"ageDistribution":{"type":"object","properties":{"0-2":{"type":"integer"},"20+":{"type":"integer"},"3-5":{"type":"integer"},"6-10":{"type":"integer"},"11-15":{"type":"integer"},"16-20":{"type":"integer"}}},"fuelMix":{"type":"object","properties":{"cng":{"type":"integer"},"lpg":{"type":"integer"},"other":{"type":"integer"},"diesel":{"type":"integer"},"hybrid":{"type":"integer"},"petrol":{"type":"integer"},"electric":{"type":"integer"}}},"topFleets":{"type":"array","items":{"type":"object","properties":{"ico":{"description":"Czech company identifier (IČO), up to 8 digits.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"ownerType":{"description":"Registry owner type of the current holder.","type":"string"},"current":{"type":"integer"}}}},"topModels":{"description":"The most-listed models with count and median price.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"count":{"description":"Number of listings the figure is based on.","type":"integer"}}}},"topDealers":{"type":"array","items":{"type":"object","properties":{"ico":{"description":"Czech company identifier (IČO), up to 8 digits.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"current":{"type":"integer"}}}},"topEver":{"type":"array","items":{"type":"object","properties":{"ico":{"description":"Czech company identifier (IČO), up to 8 digits.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"ownerType":{"description":"Registry owner type of the current holder.","type":"string"},"ever":{"type":"integer"}}}},"companyTypeCounts":{"type":"object","properties":{"AUTOSALON":{"type":"integer"},"FIRMA":{"type":"integer"},"OSVC":{"type":"integer"},"LEASING":{"type":"integer"}}}}},"example":{"available":true,"snapshotDate":"2026-10-03","fleetSummary":{"operated":10877142,"totalAll":19383927,"snapshotDate":"2026-10-03","avgSourceRows":19383927,"passengerOperated":6877787},"brandCounts":{"ŠKODA":2286831,"VOLKSWAGEN":747335,"FORD":406214,"HYUNDAI":299538,"PEUGEOT":263451,"RENAULT":258885,"TOYOTA":213535,"BMW":200423,"OPEL":196042,"MERCEDES-BENZ":190465,"CITROËN":186415,"AUDI":165926},"importStats":{"total":3449271,"countries":[{"name":"Německo","count":2020189,"share":58.6}],"byYear":{"2026":{"total":64353,"countries":{"USA":1551,"Belgie":1847,"Polsko":1822,"Dánsko":1132,"Francie":2130,"Itálie":3170,"Německo":40029,"Rakousko":3933,"Slovensko":2257,"Švédsko":587,"Nizozemsko":2312,"Švýcarsko":659}},"2027":{"total":3,"countries":{"Řecko":1,"Německo":2}},"2029":{"total":2,"countries":{"Maďarsko":1,"Nizozemsko":1}},"2034":{"total":1,"countries":{"Německo":1}},"2044":{"total":3,"countries":{"Itálie":1,"Německo":1,"Nizozemsko":1}},"2047":{"total":5,"countries":{"Dánsko":1,"Německo":4}},"2053":{"total":1,"countries":{"Německo":1}},"2054":{"total":1,"countries":{"Německo":1}},"2060":{"total":1,"countries":{"Rakousko":1}},"2084":{"total":1,"countries":{"Polsko":1}}}},"ageDistribution":{"0-2":592747,"20+":2040306,"3-5":580546,"6-10":1259600,"11-15":1147209,"16-20":1256889},"fuelMix":{"cng":21373,"lpg":122107,"other":39436,"diesel":2605497,"hybrid":79641,"petrol":3924728,"electric":85005},"topFleets":[{"ico":"45805369","name":"ŠkoFIN s.r.o.","ownerType":"LEASING","current":115897},{"ico":"60112743","name":"MONETA Auto, s.r.o.","ownerType":"FIRMA","current":48934}],"topModels":[{"brand":"ŠKODA","model":"OCTAVIA","count":705526},{"brand":"ŠKODA","model":"FABIA","count":467777}],"topDealers":[{"ico":"1759299","name":"AURES Holdings a.s.","current":27567},{"ico":"25298828","name":"AUTO IN s.r.o.","current":6085}],"topEver":[{"ico":"45805369","name":"ŠkoFIN s.r.o.","ownerType":"LEASING","ever":760346},{"ico":"1759299","name":"AURES Holdings a.s.","ownerType":"AUTOSALON","ever":546613}],"companyTypeCounts":{"AUTOSALON":1326,"FIRMA":437148,"OSVC":737096,"LEASING":29}}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/registrations/latest":{"get":{"operationId":"getLatestRegistrations","tags":["Registrations"],"summary":"Newest month of Czech new-car registrations","description":"Units registered in the latest available month with the prior-year comparison and the top brands and models by share (SDA-CIA data).","parameters":[{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"The month overview.","content":{"application/json":{"schema":{"type":"object","properties":{"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"month":{"type":"integer"},"totals":{"description":"Units registered in the month, the prior-year month and the year-over-year change.","type":"object","properties":{"units":{"description":"Vehicles registered.","type":"integer"},"unitsPriorYear":{"description":"Vehicles registered in the same month a year earlier.","type":"integer"},"yoyPct":{"description":"Year-over-year change in %.","type":"number"}}},"topBrands":{"description":"Most-listed brands with median price and 30-day trend.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"brandRaw":{"type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"null"},"units":{"description":"Vehicles registered.","type":"integer"},"sharePct":{"description":"Share of all registrations in the month, %.","type":"number"},"rank":{"type":"integer"},"unitsPriorYear":{"description":"Vehicles registered in the same month a year earlier.","type":"integer"},"sharePctPriorYear":{"type":"number"},"yoyPct":{"description":"Year-over-year change in %.","type":"number"}}}},"topModels":{"description":"The most-listed models with count and median price.","type":"array","items":{"type":"object","properties":{"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"brandRaw":{"type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"units":{"description":"Vehicles registered.","type":"integer"},"sharePct":{"description":"Share of all registrations in the month, %.","type":"number"},"rank":{"type":"integer"},"unitsPriorYear":{"description":"Vehicles registered in the same month a year earlier.","type":["integer","null"]},"sharePctPriorYear":{"type":["number","null"]},"yoyPct":{"description":"Year-over-year change in %.","type":["number","null"]}}}}}},"example":{"year":2026,"month":9,"totals":{"units":19095,"unitsPriorYear":21370,"yoyPct":-10.6},"topBrands":[{"brand":"skoda","brandRaw":"Škoda","model":null,"units":7006,"sharePct":36.69,"rank":1,"unitsPriorYear":8118,"sharePctPriorYear":37.99,"yoyPct":86.3},{"brand":"toyota","brandRaw":"Toyota","model":null,"units":1373,"sharePct":7.19,"rank":2,"unitsPriorYear":1621,"sharePctPriorYear":7.59,"yoyPct":84.7}],"topModels":[{"brand":"skoda","brandRaw":"Škoda","model":"Octavia","units":1574,"sharePct":8.24,"rank":1,"unitsPriorYear":1791,"sharePctPriorYear":8.38,"yoyPct":87.88},{"brand":"skoda","brandRaw":"Škoda","model":"Karoq","units":1070,"sharePct":5.6,"rank":2,"unitsPriorYear":1100,"sharePctPriorYear":5.15,"yoyPct":97.27}]}}}},"404":{"description":"No registration data loaded yet. Not recoverable by retrying: there is no such record or not enough data; tell the user.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"no_data"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/vehicle-check":{"get":{"operationId":"checkVehicleByVin","x-mcp-tool":"check_vehicle_by_vin","tags":["Vehicle registry"],"summary":"Free vehicle history check by VIN","description":"What the official Czech vehicle registry (Registr silničních vozidel) holds for a 17-character VIN: owner count and ownership timeline (companies named with IČO, private persons anonymous), STK inspection history with results, import origin, deregistration episodes, seized-document flags and technical data. The registry has NO mileage and NO licence-plate lookup. A VIN unknown to the monthly snapshot falls back to a rate-limited live lookup (10 per IP per day) without timelines; a VIN the Czech registry does not know answers `found: false` with the official foreign registries to try.","parameters":[{"name":"vin","in":"query","description":"17-character VIN without I, O or Q.","required":true,"schema":{"type":"string","pattern":"^[A-HJ-NPR-Z0-9]{17}$"},"example":"TMBJJ7NE4L0123456"}],"responses":{"200":{"description":"The report, or `found: false`.","content":{"application/json":{"schema":{"type":"object","properties":{"found":{"description":"true when the Czech registry knows the VIN.","type":"boolean"},"source":{"description":"Where the answer came from: dossier / snapshot (full history), listing, local (fleet table) or live (rate-limited registry API).","type":"string"},"dossier":{"allOf":[{"$ref":"#/components/schemas/RegistryDossier"}],"description":"What the registry holds for the VIN: identification, owners timeline, STK inspections, import origin, deregistrations, technical data. Never private owners’ names."},"listing":{"$ref":"#/components/schemas/Listing"},"otherRegistries":{"description":"Official foreign registries the visitor can query themselves when the Czech one does not know the VIN.","type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"country":{"description":"Market the advert belongs to (CZ, SK, PL, HU, RO). Prices are only compared within one country.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"url":{"description":"Link to the original advert.","type":"string"}}}}}},"example":{"found":true,"source":"dossier","dossier":{"tech":{"co2":"151 / 105 / 120","color":"ŠEDÁ","power":"74 / 6000","seats":"5 / 5 /","tires":"195/60 R15 88 H / 6,0JX15 ET37,5|195/60 R15 88 H / 6,0JX15 ET37,5|/ |/ |","fuelRaw":"BA","maxSpeed":173,"engineCcm":998,"weightMax":"1765/ 1765","wheelbase":"2489","dimensions":"4157/ 1764/ 1795","consumption":"6.7 / 4.6 / 5.3","factoryType":"/ JU2 / SFCD1L / 5BDAND","emissionClass":"EURO 6","weightOperating":"1280"},"brand":"FORD","model":"TOURNEO COURIER","owners":[{"to":"2026-07-27","from":"2016-12-20","role":"operator"}],"status":"PROVOZOVANÉ","category":"M1","equipment":["TAŽNÉ ZAŘÍZENÍ"],"inspections":[{"to":"2020-12-20","from":"2016-12-20","type":"P","result":"A","station":"Administrativní omezení - nové vozidlo"}],"ownersCount":3,"stkValidUntil":"2026-12-05","operatorsCount":3,"firstRegistration":"2016-12-20","yearOfManufacture":2016,"firstRegistrationCz":"2016-12-20","snapshotDate":"2026-10-03"},"listing":{"id":"53c3e9aa-404f-4b2a-ab1a-63d8ba2a0a2e","dealId":"30c92e1b-dae0-4b74-ad06-2b340306d054","isDeal":true,"priceDiffPct":65.190216,"title":"Ford Tourneo Courier, 1.0 EcoBoost 74 kW","brand":"Ford","model":"Tourneo Courier","year":2016,"priceCzk":194900,"currency":"CZK","mileageKm":43669,"fuel":"petrol","source":"sauto","url":"https://www.sauto.cz/osobni/detail/ford/tourneo-courier/210904563","imageUrl":"https://d19-a.sdn.cz/d_19/c_img_qE_A/kPVqmweP7JC1dLSCvVHc296k/cffa.jpeg","isActive":true,"lastSeenAt":"2026-10-10T06:04:55.593Z","adCount":3}}}}},"400":{"description":"Not a valid 17-character VIN. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"invalid_vin"}}}},"429":{"description":"Live-lookup budget exhausted: `busy` (shared minute budget, retry after `retryAfterS`) or `daily_limit` (10 live lookups per IP per day). Snapshot hits are never limited this way.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"description":"Machine-readable error code or message.","type":"string"},"retryAfterS":{"description":"Seconds to wait before retrying.","type":"integer"},"limit":{"description":"The limit that was hit.","type":"integer"}}},"example":{"error":"busy","retryAfterS":60}}}},"500":{"$ref":"#/components/responses/ServerError"},"502":{"description":"The live registry API did not answer. Recoverable: the upstream registry is down; retry after a minute or use the snapshot-only answer.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"registry_unavailable"}}}}}}},"/api/public/firmy":{"get":{"operationId":"searchCompanyFleets","x-mcp-tool":"search_company_fleets","tags":["Companies"],"summary":"Find Czech companies by name or IČO","description":"Companies in the vehicle registry matching a name fragment (3+ characters, accent-insensitive) or an IČO (3–8 digits), with their fleet size now and ever, largest first (max 20). Sole traders are found only by exact IČO and are never named.","parameters":[{"name":"q","in":"query","description":"Company name fragment (3+ chars) or IČO (3–8 digits).","required":true,"schema":{"type":"string","minLength":3},"example":"ŠkoFIN"}],"responses":{"200":{"description":"Matching companies.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"description":"Matching companies, largest current fleet first (max 20).","type":"array","items":{"type":"object","properties":{"ico":{"description":"Czech company identifier (IČO), up to 8 digits.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":["string","null"]},"ownerType":{"description":"Registry owner type of the current holder.","type":"string"},"vehiclesEver":{"description":"Vehicles the company has ever owned according to the registry.","type":"integer"},"vehiclesCurrent":{"description":"Vehicles the company owns now.","type":"integer"}}}}}},"example":{"results":[{"ico":"26052083","name":"AUTOSALON KUDRNA CZ a.s.","ownerType":"AUTOSALON","vehiclesEver":1502,"vehiclesCurrent":548},{"ico":"26435713","name":"Autosalon Klokočka Centrum s.r.o.","ownerType":"FIRMA","vehiclesEver":11982,"vehiclesCurrent":403}]}}}},"400":{"description":"Query shorter than 3 characters. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"query_too_short"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/public/firmy/{ico}":{"get":{"operationId":"getCompanyFleet","x-mcp-tool":"get_company_fleet","tags":["Companies"],"summary":"A company's registered fleet profile","description":"Vehicles owned and operated now and ever, median holding period, owner-type classification (dealer / leasing / company / sole trader), the paginated current fleet and former holdings, and the vehicles currently for sale on the market.","parameters":[{"name":"ico","in":"path","description":"Czech IČO, 1–8 digits (leading zeros optional).","required":true,"schema":{"type":"string","pattern":"^\\d{1,8}$"},"example":"45805369"},{"name":"flotila","in":"query","description":"Page of the current fleet, 1-based (50 per page, max page 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":1}},{"name":"historie","in":"query","description":"Page of the former holdings, 1-based (50 per page, max page 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":1}}],"responses":{"200":{"description":"The profile.","content":{"application/json":{"schema":{"type":"object","properties":{"ico":{"description":"Czech company identifier (IČO), up to 8 digits.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"ownerType":{"description":"Registry owner type of the current holder.","type":"string"},"vehiclesEver":{"description":"Vehicles the company has ever owned according to the registry.","type":"integer"},"vehiclesCurrent":{"description":"Vehicles the company owns now.","type":"integer"},"operatedEver":{"description":"Vehicles the company has ever operated (e.g. leased fleets), not owned.","type":"integer"},"operatedCurrent":{"description":"Vehicles the company operates now.","type":"integer"},"medianHoldDays":{"description":"Median number of days the company keeps a vehicle.","type":"integer"},"snapshotDate":{"description":"Date of the monthly registry snapshot the data comes from.","type":"string","format":"date"},"trackedVehicles":{"description":"Vehicles of this company AutoSignal has seen advertised.","type":"integer"},"fleetTotal":{"description":"Size of the current fleet.","type":"integer"},"fleetPage":{"type":"integer"},"fleetPageSize":{"type":"integer"},"formerTotal":{"description":"Number of former holdings.","type":"integer"},"formerPage":{"type":"integer"},"formerPageSize":{"type":"integer"},"fleet":{"description":"Current fleet, paginated (fleetPage / fleetPageSize).","type":"array","items":{"type":"object","properties":{"vin":{"description":"Vehicle identification number as published, or null. Masked VINs (XXX) are not usable.","type":"string"},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"firstRegistration":{"description":"Date of the first registration anywhere (registry).","type":"string","format":"date"},"stkValidUntil":{"type":"string","format":"date"},"status":{"description":"Status: of a registry record e.g. PROVOZOVANÉ (in operation) or VYŘAZENÉ (deregistered); of a report, published.","type":"string"},"role":{"type":"string"},"since":{"type":"string","format":"date"},"tracked":{"type":"boolean"},"forSale":{"description":"The company’s vehicles currently advertised for sale on the market.","type":"boolean"}}}},"formerFleet":{"type":"array","items":{"type":"object","properties":{"vin":{"description":"Vehicle identification number as published, or null. Masked VINs (XXX) are not usable.","type":"string"},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"status":{"description":"Status: of a registry record e.g. PROVOZOVANÉ (in operation) or VYŘAZENÉ (deregistered); of a report, published.","type":"string"},"role":{"type":"string"},"heldFrom":{"type":"string","format":"date"},"heldTo":{"type":"string","format":"date"}}}},"forSale":{"description":"The company’s vehicles currently advertised for sale on the market.","type":"array","items":{"type":"object","properties":{"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"dealId":{"description":"The deal row of this listing, or null when it is not scored as a deal (UUID).","type":"string"},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"vin":{"description":"Vehicle identification number as published, or null. Masked VINs (XXX) are not usable.","type":"string"},"priceDiffPct":{"description":"Percent below the segment median price. Positive = cheaper than comparable cars; a published deal is ≥ 12 (used) / ≥ 5 (new).","type":"integer"},"source":{"description":"Marketplace / dealer-site slug the advert was found on (e.g. sauto, tipcars, aaa-auto).","type":"string"}}}}}},"example":{"ico":"45805369","name":"ŠkoFIN s.r.o.","ownerType":"LEASING","vehiclesEver":412873,"vehiclesCurrent":98210,"operatedEver":3918,"operatedCurrent":1204,"medianHoldDays":1187,"snapshotDate":"2026-10-03","trackedVehicles":2210,"fleetTotal":98210,"fleetPage":1,"fleetPageSize":50,"formerTotal":314663,"formerPage":1,"formerPageSize":50,"fleet":[{"vin":"TMBJJ7NX5PY012345","brand":"ŠKODA","model":"OCTAVIA","year":2023,"firstRegistration":"2023-02-14","stkValidUntil":"2027-02-14","status":"PROVOZOVANÉ","role":"owner","since":"2023-02-14","tracked":true,"forSale":false}],"formerFleet":[{"vin":"TMBAG7NE3K0123456","brand":"ŠKODA","model":"SUPERB","year":2019,"status":"PROVOZOVANÉ","role":"owner","heldFrom":"2019-03-01","heldTo":"2022-04-12"}],"forSale":[{"listingId":"3f0c2a8e-6b1d-4c57-9a0e-1d2b7c9e4f11","dealId":"8d4e1b2a-0c3f-4e6a-b5d7-2f9a1c8e6b30","brand":"Škoda","model":"Octavia","year":2021,"priceCzk":399000,"vin":"TMBJJ7NX5MY054321","priceDiffPct":14,"source":"sauto"}]}}}},"400":{"description":"IČO is not 1–8 digits. Not recoverable by retrying: fix the named parameter and send again.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"invalid_ico"}}}},"404":{"description":"No company with that IČO in the registry. Not recoverable by retrying: there is no such record or not enough data; tell the user.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"example":{"error":"not_found"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"components":{"parameters":{"countries":{"name":"countries","in":"query","description":"Markets to include, comma-separated ISO codes. Default CZ. Prices are only ever compared within one country.","schema":{"type":"string","pattern":"^[A-Z]{2}(,[A-Z]{2})*$","example":"CZ"}},"country":{"name":"country","in":"query","description":"Market, one ISO code. Default CZ.","schema":{"type":"string","enum":["CZ","SK","DE","AT","PL","HU","RO"],"default":"CZ"}},"brands":{"name":"brands","in":"query","description":"Brand names, comma-separated (canonical spelling, e.g. Škoda, Mercedes-Benz).","schema":{"type":"string","description":"Brands. Comma-separated list.","example":"Škoda,Volkswagen"}},"models":{"name":"models","in":"query","description":"Model names, comma-separated; matched against the catalogue name or as a prefix of the raw model.","schema":{"type":"string","description":"Models. Comma-separated list.","example":"Octavia"}},"fuels":{"name":"fuels","in":"query","description":"Fuels, comma-separated: petrol, diesel, hybrid, electric, lpg, cng, other.","schema":{"type":"string","description":"Fuels. Comma-separated list.","example":"diesel,petrol"}},"vehicleTypes":{"name":"vehicleTypes","in":"query","description":"used, new and/or demo, comma-separated. Default: all.","schema":{"type":"string","description":"Vehicle types. Comma-separated list.","example":"used"}},"bodyTypes":{"name":"bodyTypes","in":"query","description":"Body types, comma-separated: kombi, sedan, hatchback, suv, mpv, coupe, cabrio, pickup, van.","schema":{"type":"string","description":"Body types. Comma-separated list.","example":"kombi,suv"}},"priceMin":{"name":"priceMin","in":"query","description":"Lowest asking price in CZK.","schema":{"type":"integer","minimum":0,"maximum":1000000000},"example":200000},"priceMax":{"name":"priceMax","in":"query","description":"Highest asking price in CZK.","schema":{"type":"integer","minimum":0,"maximum":1000000000},"example":500000},"yearMin":{"name":"yearMin","in":"query","description":"Oldest model year.","schema":{"type":"integer","minimum":1900,"maximum":2100},"example":2018},"yearMax":{"name":"yearMax","in":"query","description":"Newest model year.","schema":{"type":"integer","minimum":1900,"maximum":2100},"example":2022},"maxMileage":{"name":"maxMileage","in":"query","description":"Highest odometer reading in km.","schema":{"type":"integer","minimum":0,"maximum":10000000},"example":150000},"minDiscount":{"name":"minDiscount","in":"query","description":"Only cars at least this many % below their segment median.","schema":{"type":"number","minimum":0,"maximum":100},"example":20},"priceDropped":{"name":"priceDropped","in":"query","description":"`true` keeps only listings whose price was recently cut.","schema":{"type":"string","enum":["true"]}},"firstOwner":{"name":"firstOwner","in":"query","description":"`true` keeps only registry-verified one-owner cars.","schema":{"type":"string","enum":["true"]}},"czOrigin":{"name":"czOrigin","in":"query","description":"`true` keeps only cars first registered in the Czech Republic (never imported).","schema":{"type":"string","enum":["true"]}},"powerMin":{"name":"powerMin","in":"query","description":"Lowest engine power in kW.","schema":{"type":"integer","minimum":0,"maximum":2000},"example":110},"transmission":{"name":"transmission","in":"query","description":"manual or automatic.","schema":{"type":"string","enum":["manual","automatic"]}},"damaged":{"name":"damaged","in":"query","description":"`true` includes damaged / crashed cars, which are excluded by default.","schema":{"type":"string","enum":["true"]}},"mode":{"name":"mode","in":"query","description":"`all` switches from published deals to the whole market: every scored listing with its % above/below median (the webapp's \"Celý trh\").","schema":{"type":"string","enum":["all"]}},"vehicleClass":{"name":"vehicleClass","in":"query","description":"Vehicle class. Only `car` is public today; an unknown or non-public class answers as if absent (cars) or 404.","schema":{"type":"string","default":"car"}},"page":{"name":"page","in":"query","description":"Page number, 1-based.","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},"pageSize":{"name":"pageSize","in":"query","description":"Cards per page. Max 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},"limit":{"name":"limit","in":"query","description":"How many rows to return (max 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}},"schemas":{"Listing":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"source":{"description":"Marketplace / dealer-site slug the advert was found on (e.g. sauto, tipcars, aaa-auto).","type":"string"},"sourceId":{"description":"The advert's own id on the source site.","type":"string"},"url":{"description":"Link to the original advert.","type":"string"},"title":{"description":"Advert title as published by the seller.","type":"string"},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"year":{"description":"Model year (year of manufacture or first registration). 0 = not stated.","type":"integer"},"mileageKm":{"description":"Odometer reading in kilometres.","type":"integer"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"currency":{"description":"Currency of the original advert (CZK, EUR, PLN, HUF, RON).","type":"string"},"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"transmission":{"description":"manual, automatic, or null when not stated.","type":["string","null"]},"description":{"description":"Seller text, trimmed.","type":"string"},"images":{"description":"Photo URLs on the source site.","type":"array","items":{"type":"string"}},"location":{"description":"Seller location as written in the advert.","type":"string"},"country":{"description":"Market the advert belongs to (CZ, SK, PL, HU, RO). Prices are only compared within one country.","type":"string"},"vin":{"description":"Vehicle identification number as published, or null. Masked VINs (XXX) are not usable.","type":["string","null"]},"sellerType":{"description":"dealer or private.","type":"string"},"sellerName":{"description":"Dealer name when the source shows it.","type":["string","null"]},"isVatDeductible":{"description":"true when the price is quoted as VAT-deductible (business sale).","type":["boolean","null"]},"engineCapacity":{"description":"Engine displacement in cm³.","type":["integer","null"]},"powerKw":{"description":"Engine power in kW.","type":["integer","null"]},"ownersCount":{"description":"Number of registered owners from the official registry; null when unknown.","type":["integer","null"]},"ownerType":{"description":"Registry owner type of the current holder.","type":["string","null"]},"firstRegistration":{"description":"Date of the first registration anywhere (registry).","type":["string","null"],"format":"date"},"firstRegistrationCz":{"description":"Date of the first registration in the Czech Republic (registry).","type":["string","null"],"format":"date"},"registryData":{"description":"Raw registry enrichment flags (internal; shapes vary by source).","type":["object","null"],"properties":{"rsvStatus":{"type":"integer"},"rsvCheckedAt":{"type":"string","format":"date-time"},"vinCheckedAt":{"type":"string","format":"date-time"},"notInRegistry":{"type":"boolean"},"vinBackfillAt":{"type":"string","format":"date-time"},"color":{"description":"Colour as written by the seller.","type":"string"},"source":{"description":"Marketplace / dealer-site slug the advert was found on (e.g. sauto, tipcars, aaa-auto).","type":"string"},"status":{"description":"Status: of a registry record e.g. PROVOZOVANÉ (in operation) or VYŘAZENÉ (deregistered); of a report, published.","type":"string"},"co2Combined":{"type":"integer"},"emissionClass":{"type":"string"},"stkValidUntil":{"type":"string","format":"date"},"operatorsCount":{"type":"integer"},"duckSnapshotDate":{"type":"string","format":"date"},"consumptionCombined":{"type":"number"},"imagesBackfillAt":{"type":"string","format":"date-time"},"owners":{"description":"Ownership timeline. Companies are named with their IČO; private persons are anonymous by law.","type":"array","items":{"type":"object","properties":{"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"role":{"type":"string"},"period":{"type":"string"},"address":{"type":"string"}}}}}},"condition":{"description":"damaged when the advert is a crashed / damaged car, else null.","type":["string","null"]},"color":{"description":"Colour as written by the seller.","type":["string","null"]},"drivetrain":{"description":"fwd, rwd, awd, or null.","type":["string","null"]},"bodyType":{"description":"Body: kombi, sedan, hatchback, suv, mpv, coupe, cabrio, pickup, van, …","type":["string","null"]},"deduplicationKey":{"description":"Internal cross-post matcher key.","type":"string"},"canonicalModel":{"description":"Model name normalised to the AutoSignal catalogue (Czech convention: \"Řada 5\", \"Třída E\").","type":"string"},"createdAt":{"description":"When AutoSignal first saw the advert.","type":"string"},"updatedAt":{"description":"When AutoSignal last re-read the advert.","type":"string"},"isActive":{"description":"The advert is still online.","type":"boolean"},"vehicleType":{"description":"used, new or demo.","type":"string"},"isAuction":{"description":"The advert is an auction, not a fixed price.","type":"boolean"},"lastVerifiedAt":{"description":"When the advert was last confirmed online.","type":["string","null"],"format":"date-time"},"goneProbeCount":{"description":"Consecutive checks that found the advert gone.","type":"integer"},"feedGroupKey":{"description":"Internal duplicate-group key of the listing.","type":"string"},"feedIsPrimary":{"description":"The representative advert of its duplicate group.","type":"boolean"},"feedIsDeal":{"description":"Cached: the listing is a published deal.","type":"boolean"},"feedDealScore":{"description":"Cached deal score of the listing.","type":"number"},"dealId":{"description":"The deal row of this listing, or null when it is not scored as a deal (UUID).","type":"string"},"isDeal":{"description":"true when the listing is currently a published deal.","type":"boolean"},"priceDiffPct":{"description":"Percent below the segment median price. Positive = cheaper than comparable cars; a published deal is ≥ 12 (used) / ≥ 5 (new).","type":["number","null"]},"imageUrl":{"type":["string","null"]},"lastSeenAt":{"type":"string","format":"date-time"},"adCount":{"type":"integer"}},"description":"One advert as AutoSignal stores it. Prices are gross CZK; foreign adverts are converted."},"MarketStat":{"description":"The segment of comparable cars (brand, model, fuel, country, year band, mileage band) a price is judged against. At least 6 listings.","type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"fuel":{"description":"Fuel: petrol, diesel, hybrid, electric, lpg, cng, other.","type":"string"},"country":{"description":"Market the advert belongs to (CZ, SK, PL, HU, RO). Prices are only compared within one country.","type":"string"},"yearFrom":{"description":"First model year of the segment.","type":"integer"},"yearTo":{"description":"Last model year of the segment.","type":"integer"},"mileageFrom":{"description":"Lower bound of the segment mileage band in km.","type":"integer"},"mileageTo":{"description":"Upper bound of the segment mileage band in km.","type":"integer"},"avgPrice":{"description":"Average price of the segment in CZK.","type":"number"},"medianPrice":{"description":"Median price in CZK.","type":"number"},"minPrice":{"description":"Lowest price in the segment in CZK.","type":"integer"},"count":{"description":"Number of listings the figure is based on.","type":"integer"},"computedAt":{"description":"When the segment statistics were computed.","type":"string"},"widenLevel":{"description":"How far the segment had to be widened to reach the minimum sample (0 = exact year/mileage band).","type":"integer"}}},"RegistryDossier":{"description":"What the official Czech vehicle registry (RSV) holds for one VIN: identification and technical data, the ownership timeline (companies with IČO; private persons anonymous), STK inspections with results, import origin, deregistration episodes, status. Field presence depends on the source tier (snapshot vs. live lookup).","type":"object","properties":{"tech":{"type":"object","properties":{"co2":{"type":"string"},"color":{"description":"Colour as written by the seller.","type":"string"},"power":{"type":"string"},"seats":{"type":"string"},"tires":{"type":"string"},"fuelRaw":{"type":"string"},"maxSpeed":{"type":"integer"},"engineCcm":{"type":"integer"},"weightMax":{"type":"string"},"wheelbase":{"type":"string"},"dimensions":{"type":"string"},"consumption":{"type":"string"},"factoryType":{"type":"string"},"emissionClass":{"type":"string"},"weightOperating":{"type":"string"}}},"brand":{"description":"Make, canonical spelling (e.g. Škoda, Mercedes-Benz).","type":"string"},"model":{"description":"Model as the seller wrote it. Prefer canonicalModel for grouping.","type":"string"},"owners":{"description":"Ownership timeline. Companies are named with their IČO; private persons are anonymous by law.","type":"array","items":{"type":"object","properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"},"role":{"type":"string"},"ico":{"description":"Czech company identifier (IČO), up to 8 digits.","type":"string"},"name":{"description":"Registered company name; null for a natural person (sole trader), who is never named.","type":"string"},"ownerType":{"description":"Registry owner type of the current holder.","type":"string"},"current":{"type":"boolean"}}}},"status":{"description":"Status: of a registry record e.g. PROVOZOVANÉ (in operation) or VYŘAZENÉ (deregistered); of a report, published.","type":"string"},"category":{"type":"string"},"equipment":{"type":"array","items":{"type":"string"}},"inspections":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"},"type":{"type":"string"},"result":{"type":"string"},"station":{"type":"string"},"current":{"type":"boolean"}}}},"ownersCount":{"description":"Number of registered owners from the official registry; null when unknown.","type":"integer"},"stkValidUntil":{"type":"string","format":"date"},"operatorsCount":{"type":"integer"},"firstRegistration":{"description":"Date of the first registration anywhere (registry).","type":"string","format":"date"},"yearOfManufacture":{"description":"Year of manufacture from the registry.","type":"integer"},"firstRegistrationCz":{"description":"Date of the first registration in the Czech Republic (registry).","type":"string","format":"date"},"snapshotDate":{"description":"Date of the monthly registry snapshot the data comes from.","type":"string","format":"date"},"ownersPartial":{"description":"true when private-person tenures are missing from the timeline (not published by the state).","type":"boolean"}}},"Deal":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"marketStatId":{"description":"The market segment (market_stats row) the listing was scored against; null for an unscored listing.","type":"string"},"dealScore":{"description":"How far below its segment median the listing is priced, as a fraction (0.25 = 25 % below). 0 for market-tail rows.","type":"number"},"priceDiffPct":{"description":"Percent below the segment median price. Positive = cheaper than comparable cars; a published deal is ≥ 12 (used) / ≥ 5 (new).","type":"number"},"flaggedAt":{"description":"When the listing was last promoted to a published deal.","type":"string"},"isPublished":{"description":"true = a deal (priced 12 %+ below its segment median and not suppressed); false = a rated listing in the market tail.","type":"boolean"},"isMarketListing":{"description":"true for a market-tail row (rated against its segment but not a deal).","type":"boolean"},"listing":{"$ref":"#/components/schemas/Listing"},"marketStat":{"allOf":[{"$ref":"#/components/schemas/MarketStat"}],"description":"The comparable-cars segment the price is judged against."},"watchCount":{"description":"How many AutoSignal users watch this listing.","type":"integer"},"priceDrop":{"type":"integer"},"previousPrice":{"type":"integer"},"display":{"description":"Pre-computed presentation of the judgment (price badge tier, registry badges, warning flags) — what the AutoSignal UI shows.","type":"object","additionalProperties":true},"duplicates":{"description":"Other adverts of the same car (cross-posts), same shape as the parent listing.","type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"source":{"description":"Marketplace / dealer-site slug the advert was found on (e.g. sauto, tipcars, aaa-auto).","type":"string"},"url":{"description":"Link to the original advert.","type":"string"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"currency":{"description":"Currency of the original advert (CZK, EUR, PLN, HUF, RON).","type":"string"}}}},"firstPublishedAt":{"description":"When the listing first became a published deal; null if it never was.","type":"string","format":"date-time"},"hiddenByAdmin":{"description":"Manually hidden from the feed.","type":"boolean"},"hiddenAt":{"type":"null"},"groupKey":{"description":"Duplicate-group key: cross-posts of the same car share it and the feed shows one card per group.","type":"string"},"listingActive":{"description":"The advert was still online at the last check.","type":"boolean"},"listingDamaged":{"description":"The advert is marked as a damaged / crashed car.","type":"boolean"},"listingHasVin":{"description":"The advert publishes a usable 17-character VIN.","type":"boolean"},"priceDropPct":{"type":"number"},"priceHistory":{"description":"Price changes of this advert (and of relists of the same car), oldest first.","type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier (UUID).","type":"string"},"listingId":{"description":"The listing (advert) this row belongs to (UUID).","type":"string"},"priceCzk":{"description":"Asking price in CZK, gross (incl. VAT). Foreign-market adverts are converted at the daily rate.","type":"integer"},"recordedAt":{"type":"string","format":"date-time"}}}},"relist":{"description":"When the same car (same VIN) was advertised before: the earlier adverts and their prices; null otherwise.","type":"null"},"prediction":{"description":"Heuristic price-direction forecast for this advert with a Czech reason.","type":"object","properties":{"direction":{"type":"string"},"confidence":{"type":"string"},"reason":{"type":"string"}}},"registryDossier":{"oneOf":[{"$ref":"#/components/schemas/RegistryDossier"},{"type":"null"}],"description":"Official Czech registry (RSV) history for the VIN: owners, inspections, import origin; null when the VIN is unknown or missing."},"registryVinMismatch":{"description":"true when the registry names a different make than the advert — a red flag.","type":"boolean"}},"description":"A scored listing: the deal row with its listing and segment. `isPublished` says whether it is a deal (12 %+ below median) or a rated market-tail row. Detail-only fields (priceHistory, prediction, registryDossier, …) are present on GET /api/deals/{id}; the price-drop fields (priceDrop, oldPrice, droppedAt) on /recently-reduced."},"Error":{"type":"object","description":"Error envelope. `error` is a short machine-readable code or an English sentence.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]}},"responses":{"RateLimited":{"description":"Too many requests from this IP. Recoverable: wait `retry-after` seconds, then retry the same request.","headers":{"retry-after":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","const":429},"error":{"type":"string","const":"Too Many Requests"},"message":{"type":"string","example":"Rate limit exceeded, retry in 1 minute"}}},"example":{"statusCode":429,"error":"Too Many Requests","message":"Rate limit exceeded, retry in 1 minute"}}}},"ServerError":{"description":"Unexpected server error. Recoverable: retry the same request once after a few seconds; if it fails again, report it.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Internal Server Error"}}}}}},"x-mcp":{"endpoint":"https://api.autosignal.eu/mcp","transport":"streamable-http","documentation":"https://autosignal.eu/cs/mcp","registry":"eu.autosignal/autosignal"},"x-llms-txt":"https://api.autosignal.eu/llms.txt"}