Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "deal_quote", "inventory_changes", "inventory_comparables" and 9 more
before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"assumptions":{"items":{"maxLength":500,"type":"string"},"maxItems":50,"type":"array"},"durable":{"type":"boolean"},"expires_at":{"format":"date-time","type":["string","null"]},"freshness_disclosure":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"},"generated_at":{"format":"date-time","type":"string"},"inventory_last_seen_at":{"format":"date-time","type":["string","null"]}},"required":["generated_at","inventory_last_seen_at","by_rooftop"],"type":"object"},"pricing":{"additionalProperties":false,"dependentRequired":{"excluded":["pricing_coverage","pricing_disclosure"],"pricing_coverage":["excluded","pricing_disclosure"],"pricing_disclosure":["pricing_coverage","excluded"]},"properties":{"base_price":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"currency":{"const":"USD"},"excluded":{"items":{"additionalProperties":false,"properties":{"code":{"enum":["sales_tax","title","registration"]},"label":{"maxLength":40,"type":"string"},"reason":{"const":"varies_by_location"}},"required":["code","label","reason"],"type":"object"},"maxItems":3,"type":"array"},"fees_total":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"line_items":{"items":{"additionalProperties":false,"properties":{"amount":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"basis":{"enum":["firm","estimated"]},"category":{"maxLength":40,"type":"string"},"code":{"maxLength":80,"type":"string"},"fee_type":{"enum":["flat","percent"]},"included_in_price":{"type":"boolean"},"label":{"maxLength":200,"type":"string"},"taxable":{"type":"boolean"}},"required":["code","label","category","fee_type","amount","taxable"],"type":"object"},"maxItems":100,"type":"array"},"otd_total":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"pricing_coverage":{"enum":["otd_estimate","partial_estimate"]},"pricing_disclosure":{"maxLength":500,"type":"string"},"tax_total":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"}},"required":["base_price","fees_total","tax_total","otd_total","currency","line_items"],"type":"object"},"quote_id":{"oneOf":[{"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","type":"string"},{"type":"null"}]},"thread_id":{"oneOf":[{"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","type":"string"},{"type":"null"}]},"unit":{"additionalProperties":false,"properties":{"condition":{"enum":["new","used"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"}},"required":["identity","condition","model_year","make","model"],"type":"object"}},"required":["durable","thread_id","quote_id","expires_at","unit","pricing","assumptions","freshness_disclosure"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"catalog_version":{"type":"string"},"has_more":{"type":"boolean"},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"next_cursor":{"maxLength":2048,"minLength":8,"type":"string"},"resync_required":{"type":"boolean"},"round_upper":{"format":"date-time","type":"string"},"rows_emitted":{"maximum":500,"minimum":0,"type":"integer"},"rows_scanned":{"maximum":5000,"minimum":0,"type":"integer"},"scope":{"anyOf":[{"pattern":"^network:(?:US|CA)$","type":"string"},{"pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$","type":"string"}]},"tombstones":{"items":{"additionalProperties":false,"properties":{"changed_at":{"format":"date-time","type":"string"},"identity":{"maxLength":30,"minLength":5,"type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"}},"required":["rooftop_slug","identity","changed_at"],"type":"object"},"maxItems":500,"type":"array"},"upserts":{"items":{"anyOf":[{"additionalProperties":false,"properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"condition":{"enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"date_in_stock":{"format":"date","type":["string","null"]},"effective_price":{"minimum":0,"type":["number","null"]},"effective_price_source":{"enum":["special_price","asking_price",null]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"price_basis":{"const":"dealer_published","type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]}},"required":["rooftop_slug","identity","stock_number","condition","is_certified","model_year","make","model","trim","currency","asking_price","special_price","special_expiry","effective_price","effective_price_source","msrp","odometer","odometer_unit","body_style","date_in_stock","vdp_url","price_basis"],"type":"object"},{"allOf":[{"description":"The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get.","not":{"anyOf":[{"required":["photo_urls"]},{"required":["options"]},{"required":["description"]},{"required":["date_in_stock"]}]},"properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"carfax_one_owner":{"type":["boolean","null"]},"carfax_report_url":{"maxLength":500,"type":["string","null"]},"city_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"condition":{"description":"Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.","enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"description_snippet":{"maxLength":200,"type":["string","null"]},"doors":{"maximum":10,"minimum":1,"type":["integer","null"]},"drivetrain":{"maxLength":80,"type":["string","null"]},"effective_price":{"description":"An unexpired special price when present, otherwise asking price; null when neither is available.","minimum":0,"type":["number","null"]},"effective_price_source":{"description":"The field selected for effective_price, or null when effective_price is null.","enum":["special_price","asking_price",null]},"engine":{"maxLength":120,"type":["string","null"]},"engine_cylinders":{"maximum":16,"minimum":1,"type":["integer","null"]},"engine_displacement":{"maxLength":80,"minLength":1,"type":["string","null"]},"exterior_color":{"maxLength":80,"type":["string","null"]},"fuel_type":{"maxLength":80,"type":["string","null"]},"hero_photo_url":{"maxLength":300,"type":["string","null"]},"highway_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"interior_color":{"maxLength":80,"type":["string","null"]},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"options_count":{"maximum":100,"minimum":0,"type":"integer"},"passenger_capacity":{"maximum":20,"minimum":1,"type":["integer","null"]},"photo_count":{"maximum":60,"minimum":0,"type":"integer"},"price_basis":{"const":"dealer_published","type":"string"},"provenance":{"additionalProperties":false,"properties":{"enriched_fields":{"items":{"enum":["photo_urls","options","description","vdp_url","video_url","city_mpg","highway_mpg","doors","passenger_capacity","engine_cylinders","engine_displacement","carfax_one_owner","carfax_report_url","is_certified","trim","body_style","transmission","drivetrain","asking_price"]},"maxItems":19,"type":"array","uniqueItems":true},"merch_updated_at":{"format":"date-time","maxLength":40,"type":["string","null"]}},"required":["merch_updated_at","enriched_fields"],"type":"object"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"transmission":{"maxLength":80,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]},"video_url":{"maxLength":500,"type":["string","null"]}},"required":["identity","condition","model_year","make","model","hero_photo_url","photo_count","options_count","description_snippet","odometer_unit","price_basis"],"type":"object"},{"properties":{"distance_km":{"minimum":0,"type":["number","null"]},"distance_miles":{"minimum":0,"type":["number","null"]},"rooftop_name":{"maxLength":200,"type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"}},"required":["rooftop_slug","rooftop_name"],"type":"object"}]},{"allOf":[{"description":"The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here.","properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"carfax_one_owner":{"type":["boolean","null"]},"carfax_report_url":{"maxLength":500,"type":["string","null"]},"city_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"condition":{"description":"Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.","enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"description":{"maxLength":10000,"type":["string","null"]},"doors":{"maximum":10,"minimum":1,"type":["integer","null"]},"drivetrain":{"maxLength":80,"type":["string","null"]},"effective_price":{"description":"An unexpired special price when present, otherwise asking price; null when neither is available.","minimum":0,"type":["number","null"]},"effective_price_source":{"description":"The field selected for effective_price, or null when effective_price is null.","enum":["special_price","asking_price",null]},"engine":{"maxLength":120,"type":["string","null"]},"engine_cylinders":{"maximum":16,"minimum":1,"type":["integer","null"]},"engine_displacement":{"maxLength":80,"minLength":1,"type":["string","null"]},"exterior_color":{"maxLength":80,"type":["string","null"]},"fuel_type":{"maxLength":80,"type":["string","null"]},"highway_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"interior_color":{"maxLength":80,"type":["string","null"]},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"options":{"items":{"maxLength":100,"type":"string"},"maxItems":100,"type":["array","null"]},"passenger_capacity":{"maximum":20,"minimum":1,"type":["integer","null"]},"photo_urls":{"items":{"maxLength":300,"type":"string"},"maxItems":60,"type":["array","null"]},"price_basis":{"const":"dealer_published","type":"string"},"provenance":{"additionalProperties":false,"properties":{"enriched_fields":{"items":{"enum":["photo_urls","options","description","vdp_url","video_url","city_mpg","highway_mpg","doors","passenger_capacity","engine_cylinders","engine_displacement","carfax_one_owner","carfax_report_url","is_certified","trim","body_style","transmission","drivetrain","asking_price"]},"maxItems":19,"type":"array","uniqueItems":true},"merch_updated_at":{"format":"date-time","maxLength":40,"type":["string","null"]}},"required":["merch_updated_at","enriched_fields"],"type":"object"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"transmission":{"maxLength":80,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]},"video_url":{"maxLength":500,"type":["string","null"]}},"required":["identity","condition","model_year","make","model","odometer_unit","price_basis"],"type":"object"},{"properties":{"distance_km":{"minimum":0,"type":["number","null"]},"distance_miles":{"minimum":0,"type":["number","null"]},"rooftop_name":{"maxLength":200,"type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"}},"required":["rooftop_slug","rooftop_name"],"type":"object"}]}]},"maxItems":500,"type":"array"},"view":{"enum":["manifest","summary","full"]}},"required":["scope","view","upserts","tombstones","has_more","next_cursor","catalog_version","resync_required","round_upper","rows_scanned","rows_emitted"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"catalog_version":{"type":"string"},"cheapest":{"items":{"allOf":[{"description":"The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get.","not":{"anyOf":[{"required":["photo_urls"]},{"required":["options"]},{"required":["description"]},{"required":["date_in_stock"]}]},"properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"carfax_one_owner":{"type":["boolean","null"]},"carfax_report_url":{"maxLength":500,"type":["string","null"]},"city_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"condition":{"description":"Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.","enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"description_snippet":{"maxLength":200,"type":["string","null"]},"doors":{"maximum":10,"minimum":1,"type":["integer","null"]},"drivetrain":{"maxLength":80,"type":["string","null"]},"effective_price":{"description":"An unexpired special price when present, otherwise asking price; null when neither is available.","minimum":0,"type":["number","null"]},"effective_price_source":{"description":"The field selected for effective_price, or null when effective_price is null.","enum":["special_price","asking_price",null]},"engine":{"maxLength":120,"type":["string","null"]},"engine_cylinders":{"maximum":16,"minimum":1,"type":["integer","null"]},"engine_displacement":{"maxLength":80,"minLength":1,"type":["string","null"]},"exterior_color":{"maxLength":80,"type":["string","null"]},"fuel_type":{"maxLength":80,"type":["string","null"]},"hero_photo_url":{"maxLength":300,"type":["string","null"]},"highway_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"interior_color":{"maxLength":80,"type":["string","null"]},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"options_count":{"maximum":100,"minimum":0,"type":"integer"},"passenger_capacity":{"maximum":20,"minimum":1,"type":["integer","null"]},"photo_count":{"maximum":60,"minimum":0,"type":"integer"},"price_basis":{"const":"dealer_published","type":"string"},"provenance":{"additionalProperties":false,"properties":{"enriched_fields":{"items":{"enum":["photo_urls","options","description","vdp_url","video_url","city_mpg","highway_mpg","doors","passenger_capacity","engine_cylinders","engine_displacement","carfax_one_owner","carfax_report_url","is_certified","trim","body_style","transmission","drivetrain","asking_price"]},"maxItems":19,"type":"array","uniqueItems":true},"merch_updated_at":{"format":"date-time","maxLength":40,"type":["string","null"]}},"required":["merch_updated_at","enriched_fields"],"type":"object"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"transmission":{"maxLength":80,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]},"video_url":{"maxLength":500,"type":["string","null"]}},"required":["identity","condition","model_year","make","model","hero_photo_url","photo_count","options_count","description_snippet","odometer_unit","price_basis"],"type":"object"},{"properties":{"distance_km":{"minimum":0,"type":["number","null"]},"distance_miles":{"minimum":0,"type":["number","null"]},"rooftop_name":{"maxLength":200,"type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"}},"required":["rooftop_slug","rooftop_name"],"type":"object"}]},"maxItems":5,"type":"array"},"count":{"minimum":0,"type":"integer"},"disclosure":{"enum":["Advertised prices only; call quote_preview for an estimated total.","Advertised prices only, as published by the dealer."]},"filters_applied":{"additionalProperties":false,"properties":{"condition":{"enum":["new","used"]},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"make":{"type":"string"},"model":{"type":"string"},"model_year":{"type":"integer"},"model_year_expand":{"enum":[0,1],"type":"integer"},"radius_miles":{"exclusiveMinimum":0,"maximum":500,"type":"number"},"trim":{"type":["string","null"]}},"required":["make","model","model_year","model_year_expand","currency"],"type":"object"},"low_sample":{"type":"boolean"},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"price":{"additionalProperties":false,"properties":{"max":{"minimum":0,"type":["number","null"]},"median":{"minimum":0,"type":["number","null"]},"min":{"minimum":0,"type":["number","null"]},"p25":{"minimum":0,"type":["number","null"]},"p75":{"minimum":0,"type":["number","null"]}},"required":["min","p25","median","p75","max"],"type":"object"},"priced_count":{"minimum":0,"type":"integer"},"subject":{"oneOf":[{"type":"null"},{"additionalProperties":false,"properties":{"identity":{"type":"string"},"price":{"minimum":0,"type":["number","null"]},"rank":{"minimum":1,"type":["integer","null"]},"rooftop_slug":{"type":"string"},"ties":{"minimum":0,"type":"integer"}},"required":["identity","rooftop_slug","price","rank","ties"],"type":"object"}]}},"required":["filters_applied","count","priced_count","price","subject","cheapest","low_sample","disclosure","catalog_version"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}{"additionalProperties":false,"properties":{"country":{"description":"Optional consistency assertion: must equal the rooftop's country; omit it unless you are checking.","enum":["US","CA"],"type":"string"},"identity":{"maxLength":30,"minLength":5, ⟨14 unchanged words⟩
before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"unit":{"allOf":[{"description":"The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here.","properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"carfax_one_owner":{"type":["boolean","null"]},"carfax_report_url":{"maxLength":500,"type":["string","null"]},"city_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"condition":{"description":"Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.","enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"description":{"maxLength":10000,"type":["string","null"]},"doors":{"maximum":10,"minimum":1,"type":["integer","null"]},"drivetrain":{"maxLength":80,"type":["string","null"]},"effective_price":{"description":"An unexpired special price when present, otherwise asking price; null when neither is available.","minimum":0,"type":["number","null"]},"effective_price_source":{"description":"The field selected for effective_price, or null when effective_price is null.","enum":["special_price","asking_price",null]},"engine":{"maxLength":120,"type":["string","null"]},"engine_cylinders":{"maximum":16,"minimum":1,"type":["integer","null"]},"engine_displacement":{"maxLength":80,"minLength":1,"type":["string","null"]},"exterior_color":{"maxLength":80,"type":["string","null"]},"fuel_type":{"maxLength":80,"type":["string","null"]},"highway_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"interior_color":{"maxLength":80,"type":["string","null"]},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"options":{"items":{"maxLength":100,"type":"string"},"maxItems":100,"type":["array","null"]},"passenger_capacity":{"maximum":20,"minimum":1,"type":["integer","null"]},"photo_urls":{"items":{"maxLength":300,"type":"string"},"maxItems":60,"type":["array","null"]},"price_basis":{"const":"dealer_published","type":"string"},"provenance":{"additionalProperties":false,"properties":{"enriched_fields":{"items":{"enum":["photo_urls","options","description","vdp_url","video_url","city_mpg","highway_mpg","doors","passenger_capacity","engine_cylinders","engine_displacement","carfax_one_owner","carfax_report_url","is_certified","trim","body_style","transmission","drivetrain","asking_price"]},"maxItems":19,"type":"array","uniqueItems":true},"merch_updated_at":{"format":"date-time","maxLength":40,"type":["string","null"]}},"required":["merch_updated_at","enriched_fields"],"type":"object"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"transmission":{"maxLength":80,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]},"video_url":{"maxLength":500,"type":["string","null"]}},"required":["identity","condition","model_year","make","model","odometer_unit","price_basis"],"type":"object"},{"not":{"required":["date_in_stock"]}}]}},"required":["unit"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"oneOf":[{"additionalProperties":false,"properties":{"catalog_watermark":{"type":["string","null"]},"dimensions":{"additionalProperties":false,"description":"Contains one property for each requested dimension.","properties":{"body_style":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"condition":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"drivetrain":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"exterior_color":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"fuel_type":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"make":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"make_model":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"model":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"model_year":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"},"rooftop":{"additionalProperties":false,"description":"values contains at most 20 nonmissing values ordered by count descending then value ascending. other_count covers nonmissing values outside the top 20; missing_count includes both null and blank strings.","properties":{"missing_count":{"minimum":0,"type":"integer"},"other_count":{"minimum":0,"type":"integer"},"values":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"value":{"type":"string"}},"required":["value","count"],"type":"object"},"maxItems":20,"type":"array"}},"required":["values","other_count","missing_count"],"type":"object"}},"type":"object"},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"price":{"additionalProperties":false,"properties":{"currency":{"type":"string"},"max":{"minimum":0,"type":["number","null"]},"median":{"minimum":0,"type":["number","null"]},"min":{"minimum":0,"type":["number","null"]},"priced_count":{"minimum":0,"type":"integer"}},"required":["currency","priced_count","min","max","median"],"type":"object"},"rooftop_slugs_covered":{"items":{"type":"string"},"maxItems":20,"type":"array","uniqueItems":true},"total":{"minimum":0,"type":"integer"}},"required":["total","dimensions","price","catalog_watermark"],"type":"object"},{"additionalProperties":false,"properties":{"catalog_version":{"type":"string"},"catalog_watermark":{"type":["string","null"]},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"pivot":{"additionalProperties":false,"properties":{"group_by":{"items":{"type":"string"},"maxItems":2,"minItems":1,"type":"array","uniqueItems":true},"missing":{"additionalProperties":false,"properties":{"age_band":{"type":"integer"},"body_style":{"type":"integer"},"condition":{"type":"integer"},"dealer_group":{"type":"integer"},"drivetrain":{"type":"integer"},"exterior_color":{"type":"integer"},"fuel_type":{"type":"integer"},"make":{"type":"integer"},"make_model":{"type":"integer"},"model":{"type":"integer"},"model_year":{"type":"integer"},"price_band":{"type":"integer"},"rooftop":{"type":"integer"},"state":{"type":"integer"}},"type":"object"},"other":{"oneOf":[{"additionalProperties":false,"properties":{"age_band":{"type":"string"},"body_style":{"type":"string"},"condition":{"type":"string"},"count":{"minimum":0,"type":"integer"},"days_in_stock_median":{"minimum":0,"type":["number","null"]},"dealer_group":{"type":"string"},"dealer_group_name":{"type":["string","null"]},"drivetrain":{"type":"string"},"exterior_color":{"type":"string"},"fuel_type":{"type":"string"},"make":{"type":"string"},"make_model":{"type":"string"},"model":{"type":"string"},"model_year":{"type":"string"},"odometer_median":{"minimum":0,"type":["number","null"]},"price_band":{"type":"string"},"price_max":{"minimum":0,"type":["number","null"]},"price_median":{"minimum":0,"type":["number","null"]},"price_min":{"minimum":0,"type":["number","null"]},"priced_count":{"minimum":0,"type":"integer"},"rooftop":{"type":"string"},"state":{"type":"string"}},"required":["count","priced_count","price_min","price_median","price_max","odometer_median","days_in_stock_median"],"type":"object"},{"type":"null"}]},"rows":{"items":{"additionalProperties":false,"properties":{"age_band":{"type":"string"},"body_style":{"type":"string"},"condition":{"type":"string"},"count":{"minimum":0,"type":"integer"},"days_in_stock_median":{"minimum":0,"type":["number","null"]},"dealer_group":{"type":"string"},"dealer_group_name":{"type":["string","null"]},"drivetrain":{"type":"string"},"exterior_color":{"type":"string"},"fuel_type":{"type":"string"},"make":{"type":"string"},"make_model":{"type":"string"},"model":{"type":"string"},"model_year":{"type":"string"},"odometer_median":{"minimum":0,"type":["number","null"]},"price_band":{"type":"string"},"price_max":{"minimum":0,"type":["number","null"]},"price_median":{"minimum":0,"type":["number","null"]},"price_min":{"minimum":0,"type":["number","null"]},"priced_count":{"minimum":0,"type":"integer"},"rooftop":{"type":"string"},"state":{"type":"string"}},"required":["count","priced_count","price_min","price_median","price_max","odometer_median","days_in_stock_median"],"type":"object"},"maxItems":200,"type":"array"}},"required":["group_by","rows","other","missing"],"type":"object"},"price":{"additionalProperties":false,"properties":{"currency":{"type":"string"},"max":{"minimum":0,"type":["number","null"]},"median":{"minimum":0,"type":["number","null"]},"min":{"minimum":0,"type":["number","null"]},"priced_count":{"minimum":0,"type":"integer"}},"required":["currency","priced_count","min","max","median"],"type":"object"},"rooftop_slugs_covered":{"items":{"type":"string"},"maxItems":20,"type":"array","uniqueItems":true},"total":{"minimum":0,"type":"integer"}},"required":["total","pivot","price","catalog_watermark","catalog_version"],"type":"object"},{"additionalProperties":false,"properties":{"catalog_version":{"type":"string"},"catalog_watermark":{"type":["string","null"]},"csv":{"type":"string"},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"price":{"additionalProperties":false,"properties":{"currency":{"type":"string"},"max":{"minimum":0,"type":["number","null"]},"median":{"minimum":0,"type":["number","null"]},"min":{"minimum":0,"type":["number","null"]},"priced_count":{"minimum":0,"type":"integer"}},"required":["currency","priced_count","min","max","median"],"type":"object"},"rows":{"items":{"additionalProperties":false,"properties":{"age_band":{"type":"string"},"body_style":{"type":"string"},"condition":{"type":"string"},"count":{"minimum":0,"type":"integer"},"days_in_stock_median":{"minimum":0,"type":["number","null"]},"dealer_group":{"type":"string"},"dealer_group_name":{"type":["string","null"]},"drivetrain":{"type":"string"},"exterior_color":{"type":"string"},"fuel_type":{"type":"string"},"make":{"type":"string"},"make_model":{"type":"string"},"model":{"type":"string"},"model_year":{"type":"string"},"odometer_median":{"minimum":0,"type":["number","null"]},"price_band":{"type":"string"},"price_max":{"minimum":0,"type":["number","null"]},"price_median":{"minimum":0,"type":["number","null"]},"price_min":{"minimum":0,"type":["number","null"]},"priced_count":{"minimum":0,"type":"integer"},"rooftop":{"type":"string"},"state":{"type":"string"}},"required":["count","priced_count","price_min","price_median","price_max","odometer_median","days_in_stock_median"],"type":"object"},"maxItems":201,"type":"array"},"total":{"minimum":0,"type":"integer"}},"required":["csv","rows","total","price","catalog_watermark","catalog_version"],"type":"object"}]},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"binding":{"maxLength":16384,"minLength":1,"type":"string"},"disclosure_text":{"maxLength":5000,"minLength":10,"type":"string"},"expires_at":{"format":"date-time","maxLength":40,"type":"string"},"quote_included":{"type":"boolean"}},"required":["disclosure_text","binding","expires_at","quote_included"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"lead_id":{"maxLength":36,"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","type":"string"},"status":{"const":"accepted"}},"required":["lead_id","status"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"rooftops":{"items":{"additionalProperties":false,"properties":{"address":{"maxLength":200,"type":"string"},"available_units":{"description":"null when the rooftop is not part of network aggregation (network opt-out)","minimum":0,"type":["integer","null"]},"city":{"maxLength":100,"type":"string"},"country":{"enum":["US","CA"],"type":"string"},"dealer_group":{"additionalProperties":false,"properties":{"name":{"maxLength":200,"type":"string"},"slug":{"maxLength":80,"type":"string"}},"required":["name","slug"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"hours":{"type":"object"},"latitude":{"maximum":90,"minimum":-90,"type":"number"},"limitations":{"items":{"type":"string"},"type":"array"},"longitude":{"maximum":180,"minimum":-180,"type":"number"},"manifest_url":{"maxLength":300,"type":"string"},"name":{"maxLength":200,"type":"string"},"new_units":{"description":"null when the rooftop is not part of network aggregation (network opt-out)","minimum":0,"type":["integer","null"]},"oem_programs":{"items":{"maxLength":80,"type":"string"},"maxItems":20,"type":"array"},"phone":{"maxLength":30,"type":"string"},"price_median":{"description":"null when the rooftop is not part of network aggregation (network opt-out)","minimum":0,"type":["number","null"]},"priced_count":{"description":"null when the rooftop is not part of network aggregation (network opt-out)","minimum":0,"type":["integer","null"]},"slug":{"maxLength":80,"type":"string"},"state":{"maxLength":50,"type":"string"},"top_makes":{"items":{"maxLength":80,"type":"string"},"maxItems":3,"type":"array"},"used_units":{"description":"null when the rooftop is not part of network aggregation (network opt-out)","minimum":0,"type":["integer","null"]},"website_url":{"maxLength":300,"type":"string"},"zip":{"maxLength":20,"type":"string"}},"required":["name","slug","country","dealer_group","oem_programs","available_units","new_units","used_units","top_makes","priced_count","price_median","freshness"],"type":"object"},"maxItems":500,"type":"array"},"total":{"minimum":0,"type":"integer"}},"required":["rooftops","total"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"catalog_version":{"type":"string"},"catalog_watermark":{"description":"Opaque revision token for the network catalog. Changes whenever an inventory ingestion is applied anywhere in the network; monotonic per catalog but carries NO timestamp semantics — compare for equality only. Null before the first ingest. Covers ingestion only: administrative reconfiguration (rooftop activation, exclusion rules, coordinates) can shift result rows without changing this token — most such events also change total, which the traversal recipe compares as well.","type":["string","null"]},"count":{"minimum":0,"type":"integer"},"csv":{"type":"string"},"format":{"enum":["json","csv"]},"has_more":{"type":"boolean"},"hint":{"additionalProperties":false,"properties":{"arguments":{"type":"object"},"reason":{"enum":["page_cap","deep_offset"]},"tool":{"enum":["inventory_stats","network_snapshot"]}},"required":["tool","arguments","reason"],"type":"object"},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"next_offset":{"minimum":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"units":{"items":{"anyOf":[{"allOf":[{"description":"The slim public projection of one inventory search result. Heavy merchandising fields are available through inventory_get.","not":{"anyOf":[{"required":["photo_urls"]},{"required":["options"]},{"required":["description"]},{"required":["date_in_stock"]}]},"properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"carfax_one_owner":{"type":["boolean","null"]},"carfax_report_url":{"maxLength":500,"type":["string","null"]},"city_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"condition":{"description":"Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.","enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"description_snippet":{"maxLength":200,"type":["string","null"]},"doors":{"maximum":10,"minimum":1,"type":["integer","null"]},"drivetrain":{"maxLength":80,"type":["string","null"]},"effective_price":{"description":"An unexpired special price when present, otherwise asking price; null when neither is available.","minimum":0,"type":["number","null"]},"effective_price_source":{"description":"The field selected for effective_price, or null when effective_price is null.","enum":["special_price","asking_price",null]},"engine":{"maxLength":120,"type":["string","null"]},"engine_cylinders":{"maximum":16,"minimum":1,"type":["integer","null"]},"engine_displacement":{"maxLength":80,"minLength":1,"type":["string","null"]},"exterior_color":{"maxLength":80,"type":["string","null"]},"fuel_type":{"maxLength":80,"type":["string","null"]},"hero_photo_url":{"maxLength":300,"type":["string","null"]},"highway_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"interior_color":{"maxLength":80,"type":["string","null"]},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"options_count":{"maximum":100,"minimum":0,"type":"integer"},"passenger_capacity":{"maximum":20,"minimum":1,"type":["integer","null"]},"photo_count":{"maximum":60,"minimum":0,"type":"integer"},"price_basis":{"const":"dealer_published","type":"string"},"provenance":{"additionalProperties":false,"properties":{"enriched_fields":{"items":{"enum":["photo_urls","options","description","vdp_url","video_url","city_mpg","highway_mpg","doors","passenger_capacity","engine_cylinders","engine_displacement","carfax_one_owner","carfax_report_url","is_certified","trim","body_style","transmission","drivetrain","asking_price"]},"maxItems":19,"type":"array","uniqueItems":true},"merch_updated_at":{"format":"date-time","maxLength":40,"type":["string","null"]}},"required":["merch_updated_at","enriched_fields"],"type":"object"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"transmission":{"maxLength":80,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]},"video_url":{"maxLength":500,"type":["string","null"]}},"required":["identity","condition","model_year","make","model","hero_photo_url","photo_count","options_count","description_snippet","odometer_unit","price_basis"],"type":"object"},{"properties":{"distance_km":{"minimum":0,"type":["number","null"]},"distance_miles":{"minimum":0,"type":["number","null"]},"rooftop_name":{"maxLength":200,"type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"}},"required":["rooftop_slug","rooftop_name"],"type":"object"}]},{"additionalProperties":false,"properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"condition":{"enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"date_in_stock":{"format":"date","type":["string","null"]},"effective_price":{"minimum":0,"type":["number","null"]},"effective_price_source":{"enum":["special_price","asking_price",null]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"price_basis":{"const":"dealer_published","type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]}},"required":["rooftop_slug","identity","stock_number","condition","is_certified","model_year","make","model","trim","currency","asking_price","special_price","special_expiry","effective_price","effective_price_source","msrp","odometer","odometer_unit","body_style","date_in_stock","vdp_url","price_basis"],"type":"object"},{"allOf":[{"description":"The public projection of one inventory unit. No source attributes, internal ids, or ingest metadata ever appear here.","properties":{"asking_price":{"minimum":0,"type":["number","null"]},"body_style":{"maxLength":80,"type":["string","null"]},"carfax_one_owner":{"type":["boolean","null"]},"carfax_report_url":{"maxLength":500,"type":["string","null"]},"city_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"condition":{"description":"Normalized vehicle condition. CLOSED vocabulary: ADN normalizes every dealer feed into exactly these values at ingestion, and the database enforces them, so consumers may switch on this field exhaustively. Certification is separate — see is_certified.","enum":["new","used"]},"currency":{"maxLength":3,"type":["string","null"]},"description":{"maxLength":10000,"type":["string","null"]},"doors":{"maximum":10,"minimum":1,"type":["integer","null"]},"drivetrain":{"maxLength":80,"type":["string","null"]},"effective_price":{"description":"An unexpired special price when present, otherwise asking price; null when neither is available.","minimum":0,"type":["number","null"]},"effective_price_source":{"description":"The field selected for effective_price, or null when effective_price is null.","enum":["special_price","asking_price",null]},"engine":{"maxLength":120,"type":["string","null"]},"engine_cylinders":{"maximum":16,"minimum":1,"type":["integer","null"]},"engine_displacement":{"maxLength":80,"minLength":1,"type":["string","null"]},"exterior_color":{"maxLength":80,"type":["string","null"]},"fuel_type":{"maxLength":80,"type":["string","null"]},"highway_mpg":{"maximum":999,"minimum":1,"type":["integer","null"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"interior_color":{"maxLength":80,"type":["string","null"]},"is_certified":{"type":["boolean","null"]},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"},"msrp":{"minimum":0,"type":["number","null"]},"odometer":{"minimum":0,"type":["integer","null"]},"odometer_unit":{"enum":["mi","km"],"type":"string"},"options":{"items":{"maxLength":100,"type":"string"},"maxItems":100,"type":["array","null"]},"passenger_capacity":{"maximum":20,"minimum":1,"type":["integer","null"]},"photo_urls":{"items":{"maxLength":300,"type":"string"},"maxItems":60,"type":["array","null"]},"price_basis":{"const":"dealer_published","type":"string"},"provenance":{"additionalProperties":false,"properties":{"enriched_fields":{"items":{"enum":["photo_urls","options","description","vdp_url","video_url","city_mpg","highway_mpg","doors","passenger_capacity","engine_cylinders","engine_displacement","carfax_one_owner","carfax_report_url","is_certified","trim","body_style","transmission","drivetrain","asking_price"]},"maxItems":19,"type":"array","uniqueItems":true},"merch_updated_at":{"format":"date-time","maxLength":40,"type":["string","null"]}},"required":["merch_updated_at","enriched_fields"],"type":"object"},"special_expiry":{"format":"date","maxLength":10,"type":["string","null"]},"special_price":{"minimum":0,"type":["number","null"]},"stock_number":{"maxLength":40,"type":["string","null"]},"transmission":{"maxLength":80,"type":["string","null"]},"trim":{"maxLength":120,"type":["string","null"]},"vdp_url":{"maxLength":500,"type":["string","null"]},"video_url":{"maxLength":500,"type":["string","null"]}},"required":["identity","condition","model_year","make","model","odometer_unit","price_basis"],"type":"object"},{"properties":{"distance_km":{"minimum":0,"type":["number","null"]},"distance_miles":{"minimum":0,"type":["number","null"]},"rooftop_name":{"maxLength":200,"type":"string"},"rooftop_slug":{"maxLength":80,"type":"string"}},"required":["rooftop_slug","rooftop_name"],"type":"object"}]}]},"maxItems":500,"type":"array"},"view":{"enum":["summary","manifest","full"]}},"required":["total","count","units","catalog_watermark","has_more","catalog_version"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"as_of_business_date":{"format":"date","type":"string"},"bytes":{"minimum":0,"type":"integer"},"bytes_compressed":{"minimum":0,"type":"integer"},"catalog_version":{"type":"string"},"etag":{"type":"string"},"expires_at":{"format":"date-time","type":"string"},"format":{"enum":["csv","json"]},"generated_at":{"format":"date-time","type":"string"},"market":{"additionalProperties":false,"properties":{"country":{"enum":["US","CA"],"type":"string"},"currency":{"type":"string"},"odometer_unit":{"enum":["mi","km"],"type":"string"}},"required":["country","currency","odometer_unit"],"type":"object"},"rows":{"minimum":0,"type":"integer"},"rows_inline":{"items":{"type":"object"},"type":"array"},"schema_version":{"const":1},"scope":{"anyOf":[{"pattern":"^network:(?:US|CA)$","type":"string"},{"pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$","type":"string"}]},"snapshot_id":{"pattern":"^[0-9a-f]{24}$","type":"string"},"sync_cursor":{"type":"string"},"url":{"format":"uri","type":"string"},"view":{"enum":["manifest","summary","full"]}},"required":["snapshot_id","schema_version","scope","view","format","generated_at","as_of_business_date","rows","bytes","bytes_compressed","etag","url","expires_at","catalog_version"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"assumptions":{"items":{"maxLength":500,"type":"string"},"maxItems":50,"type":"array"},"freshness_disclosure":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"},"generated_at":{"format":"date-time","type":"string"},"inventory_last_seen_at":{"format":"date-time","type":["string","null"]}},"required":["generated_at","inventory_last_seen_at","by_rooftop"],"type":"object"},"pricing":{"additionalProperties":false,"dependentRequired":{"excluded":["pricing_coverage","pricing_disclosure"],"pricing_coverage":["excluded","pricing_disclosure"],"pricing_disclosure":["pricing_coverage","excluded"]},"properties":{"base_price":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"currency":{"const":"USD"},"excluded":{"items":{"additionalProperties":false,"properties":{"code":{"enum":["sales_tax","title","registration"]},"label":{"maxLength":40,"type":"string"},"reason":{"const":"varies_by_location"}},"required":["code","label","reason"],"type":"object"},"maxItems":3,"type":"array"},"fees_total":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"line_items":{"items":{"additionalProperties":false,"properties":{"amount":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"basis":{"enum":["firm","estimated"]},"category":{"maxLength":40,"type":"string"},"code":{"maxLength":80,"type":"string"},"fee_type":{"enum":["flat","percent"]},"included_in_price":{"type":"boolean"},"label":{"maxLength":200,"type":"string"},"taxable":{"type":"boolean"}},"required":["code","label","category","fee_type","amount","taxable"],"type":"object"},"maxItems":100,"type":"array"},"otd_total":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"},"pricing_coverage":{"enum":["otd_estimate","partial_estimate"]},"pricing_disclosure":{"maxLength":500,"type":"string"},"tax_total":{"description":"Exact decimal amount with two places (never a JSON float).","pattern":"^-?[0-9]+\\.[0-9]{2}$","type":"string"}},"required":["base_price","fees_total","tax_total","otd_total","currency","line_items"],"type":"object"},"unit":{"additionalProperties":false,"properties":{"condition":{"enum":["new","used"]},"identity":{"maxLength":30,"minLength":5,"type":"string"},"make":{"maxLength":80,"type":"string"},"model":{"maxLength":80,"type":"string"},"model_year":{"maximum":2100,"minimum":1950,"type":"integer"}},"required":["identity","condition","model_year","make","model"],"type":"object"}},"required":["unit","pricing","assumptions","freshness_disclosure"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}before
—after
{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"properties":{"store":{"allOf":[{"description":"The public projection of one rooftop's store metadata. NULL holders are omitted, never fabricated.","properties":{"address":{"maxLength":200,"type":"string"},"city":{"maxLength":100,"type":"string"},"country":{"enum":["US","CA"],"type":"string"},"dealer_group":{"additionalProperties":false,"properties":{"name":{"maxLength":200,"type":"string"},"slug":{"maxLength":80,"type":"string"}},"required":["name","slug"],"type":"object"},"hours":{"type":"object"},"latitude":{"maximum":90,"minimum":-90,"type":"number"},"limitations":{"items":{"maxLength":500,"type":"string"},"maxItems":1,"type":"array"},"longitude":{"maximum":180,"minimum":-180,"type":"number"},"manifest_url":{"maxLength":300,"type":"string"},"name":{"maxLength":200,"type":"string"},"oem_programs":{"items":{"maxLength":80,"type":"string"},"maxItems":20,"type":"array"},"phone":{"maxLength":30,"type":"string"},"slug":{"maxLength":80,"type":"string"},"state":{"maxLength":50,"type":"string"},"website_url":{"maxLength":300,"type":"string"},"zip":{"maxLength":20,"type":"string"}},"required":["name","slug","country","dealer_group","oem_programs"],"type":"object"},{"properties":{"fee_schedule":{"items":{"additionalProperties":false,"properties":{"amount":{"minimum":0,"type":"number"},"applies_to":{"enum":["new","used","all"]},"category":{"enum":["fee","tax","title_reg"]},"code":{"maxLength":60,"type":"string"},"effective_from":{"format":"date","type":"string"},"fee_type":{"enum":["flat","percent"]},"jurisdiction":{"maxLength":60,"type":["string","null"]},"label":{"maxLength":200,"type":"string"},"taxable":{"type":"boolean"}},"required":["code","label","category","fee_type","amount"],"type":"object"},"maxItems":100,"type":"array"}},"type":"object"}]}},"required":["store"],"type":"object"},"error":{"additionalProperties":false,"description":"Unknown and foreign thread ids are deliberately indistinguishable: both return invalid_params with message \"unknown thread_id\" (anti-enumeration).","properties":{"auth_help_url":{"description":"Present only when no credential was supplied for a capability that requires one. Points to human documentation for obtaining a key. Absent for invalid, pending, or disabled credentials, which are deliberately indistinguishable.","format":"uri","maxLength":500,"type":"string"},"code":{"enum":["rooftop_not_found","rooftop_inactive","unit_not_found","invalid_params","rate_limited","upstream_unavailable","capability_unavailable","identity_required","quota_exceeded","unit_held","quote_expired","rooftop_paused","handoff_duplicate","idempotency_conflict","price_unavailable","snapshot_expired","artifact_too_large","cursor_invalid","cursor_expired","ambiguous_identity","unsupported_in_country"]},"message":{"maxLength":500,"type":"string"},"retry_after_seconds":{"minimum":0,"type":"integer"},"retryable":{"type":"boolean"}},"required":["code","message","retryable"],"type":"object"},"freshness":{"additionalProperties":false,"properties":{"by_rooftop":{"additionalProperties":{"additionalProperties":false,"properties":{"last_ingest_at":{"format":"date-time","maxLength":40,"type":["string","null"]},"status":{"enum":["fresh","stale","no_data"]}},"required":["status","last_ingest_at"],"type":"object"},"maxProperties":500,"type":"object"}},"required":["by_rooftop"],"type":"object"}},"type":"object"}Changed the definition of "inventory_stats", "lead_prepare" and "network_search"
⟨266 unchanged words⟩ "minimum":-90,"type":"number"},"listed_only":{"description":"When true, only units with at least one stored photo and a vehicle detail page (vdp_url). Absent or false returns every available unit, including stock the dealer has not merchandised yet.","type":"boolean"},"longitude":{"maximum":180,"minimum":-180, ⟨168 unchanged words⟩
⟨88 unchanged words⟩ ["name"],"type":"object"},"include_quote":{"default":true,"description":"Set false when the shopper was not shown a quote: the disclosure then makes no price claim and quote_included is false.","type":"boolean"},"rooftop_slug":{"maxLength":80,"minLength":1, ⟨16 unchanged words⟩
Changed the definition of "network_search"
⟨472 unchanged words⟩ a-z0-9])?$","type":"string"},"rooftop_slugs":{"description":"Restrict results to these network rooftops.","items":{"pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$","type":"string"},"maxItems":20,"minItems":1,"type":"array","uniqueItems":true},"sort":{"description":"Optional ordering; defaults to ⟨69 unchanged words⟩
Changed the definition of "inventory_comparables"
⟨61 unchanged words⟩ ,"CA"],"type":"string"},"currency":{"pattern":"^[A-Z]{3}$","type":"string"},"identity":{"maxLength":64,"minLength":1, ⟨73 unchanged words⟩
Changed the definition of "deal_quote" and "lead_submit"
{"destructiveHint":falsetrue,"idempotentHint":true,"openWorldHint":true,"readOnlyHint" ⟨5 unchanged words⟩
{"destructiveHint":falsetrue,"idempotentHint":true,"openWorldHint":true,"readOnlyHint" ⟨10 unchanged words⟩
Certificate changed, valid to 2026-12-20
Changed the definition of "inventory_changes", "inventory_comparables", "inventory_stats" and 3 more
⟨47 unchanged words⟩ {"cursor": "<sync_cursor from network_snapshot>"}. Pass country=CA for Canadian dealers.
{"additionalProperties":false,"properties":{"country":{"default":"US","description":"Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.","enum":["US","CA"],"type":"string"},"cursor":{"maxLength":2048,"minLength":8,"type":"string"},"rooftop_slug":{"pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$","type":"string"},"view":{" ⟨8 unchanged words⟩
Added "inventory_changes", "inventory_comparables" and "network_snapshot"; changed the definition of "inventory_stats", "lead_prepare" and "network_search" (9 tools before, 12 now)
SummarizeCount and summarize network inventory
Aggregatefilteredavailable inventory across thenetwork.network in ONE call: counts, effective-price min/median/max and the top values per facet. Example: {"dimensions": ["make_model", "body_style"], "condition": "used", "rooftop_slugs": ["mms"]}. Geo (latitude and longitude, optional radius_miles) and oem_program_slug scope exactly as network_search. Pivot mode (group_by, up to 2 of the facets plus state, dealer_group, price_band, age_band) returns one row per group with count and medians; dimensions and group_by are mutually exclusive; format csv returns the rows as CSV.
Changed the definition of "network_search"
⟨32 unchanged words⟩ OEM program scope; optional geographic radius — latitude,and longitude,andtogether; radius_milesmustdefaultsappeartotogether50 (all-or-nonemax 500).and needs both. Rooftops without coordinates are excluded from geo-scoped results. ⟨38 unchanged words⟩
Certificate recorded, valid to 2026-10-22
Authorization not required
First tool surface recorded: 9 tools (server version 0.3.0)
Showing the latest 12 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨216 unchanged words⟩ "minimum":1,"type":"integer"},"listed_only":{"description":"When true, only units with at least one stored photo and a vehicle detail page (vdp_url). Absent or false returns every available unit, including stock the dealer has not merchandised yet.","type":"boolean"},"longitude":{"maximum":180,"minimum":-180, ⟨354 unchanged words⟩
⟨51 unchanged words⟩ Advertised prices only; call quote_preview for a total. Pass country=CA for Canadian dealers.
⟨31 unchanged words⟩ "enum":["new","used"]},"currencycountry":{"patterndefault":"^US","description":"Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.","enum":[A-Z]{3}$"US","CA"],"type":"string"},"identity":{" ⟨77 unchanged words⟩
⟨67 unchanged words⟩ exclusive; format csv returns the rows as CSV. Pass country=CA for Canadian dealers.
⟨72 unchanged words⟩ "enum":["new","used"]},"country":{"default":"US","description":"Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.","enum":["US","CA"],"type":"string"},"dimensions":{"description":"One to four unique ⟨332 unchanged words⟩
⟨10 unchanged words⟩ programs, location metadata, and per-rooftop manifest URL. Pass country=CA for Canadian dealers.
{"additionalProperties":false,"properties":{"country":{"default":"US","description":"Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.","enum":["US","CA"],"type":"string"},"limit":{"maximum":500,"minimum":1, ⟨11 unchanged words⟩
⟨76 unchanged words⟩ Rooftops without coordinates are excluded from geo-scoped results. Pass country=CA for Canadian dealers. Listed prices may exclude doc/government fees and tax ⟨30 unchanged words⟩
⟨69 unchanged words⟩ "enum":["new","used"]},"country":{"default":"US","description":"Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.","enum":["US","CA"],"type":"string"},"drivetrain":{"oneOf":[{"maxLength":80, ⟨445 unchanged words⟩
⟨72 unchanged words⟩ changes; poll inventory_changes with sync_cursor to stay current. Pass country=CA for Canadian dealers.
{"additionalProperties":false,"properties":{"country":{"default":"US","description":"Market to search; rooftops in the other country are excluded. Prices are in that country's currency; the radius stays in miles.","enum":["US","CA"],"type":"string"},"format":{"default":"csv","enum": ⟨23 unchanged words⟩
⟨15 unchanged words⟩ together. Aggregation has no pagination or sorting input. Server-enforced: latitude requires longitude; longitude requires latitude; radius_miles requires latitude and longitude. Exactly one of dimensions | group_by is required. Additional argument rules are enforced server-side.","properties":{"body_style":{"oneOf": ⟨104 unchanged words⟩ ":1,"type":"array"}]},"format":{"enum":["json","csv"]},"fuel_type":{"oneOf":[{"maxLength":80, ⟨14 unchanged words⟩ ":1,"type":"array"}]},"group_by":{"items":{"enum":["make","model","make_model","condition","body_style","fuel_type","drivetrain","exterior_color","model_year","rooftop","state","dealer_group","price_band","age_band"]},"maxItems":2,"minItems":1,"type":"array","uniqueItems":true},"interior_color":{"oneOf":[{"maxLength":80, ⟨17 unchanged words⟩ ,"is_certified":{"type":"boolean"},"latitude":{"maximum":90,"minimum":-90,"type":"number"},"longitude":{"maximum":180,"minimum":-180,"type":"number"},"make":{"oneOf":[{"maxLength":80, ⟨53 unchanged words⟩ "minimum":0,"type":"integer"},"oem_program_slug":{"maxLength":80,"minLength":1,"type":"string"},"passenger_capacity_min":{"maximum":20,"minimum":1, ⟨22 unchanged words⟩ "minimum":0,"type":"number"},"radius_miles":{"exclusiveMinimum":0,"maximum":500,"type":"number"},"rooftop_slugs":{"description":"Restrict the single-snapshot aggregation ⟨48 unchanged words⟩ ,"minLength":1,"type":"string"}},"required":["dimensions"],"type":"object"}
⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":true,"title":"SummarizeCount and summarize network inventory"}
{"additionalProperties":false,"allOf":[{"if":{"properties":{"customer":{"required":["email"]}}},"then":{"propertiesdescription":{"customer.email requires channels":{"contains":{"const":"email"}}}}},{"if":{"properties":{"customer":{"required":["phone"]}}},"then":{"properties":{"to include email. customer.phone requires channels":{"contains":{"const":"phoneto include phone."}}}}}],"properties":{"channels":{"items":{ ⟨94 unchanged words⟩
SearchBrowse available inventory across thenetwork.network, one page at a time. For counts or distributions call inventory_stats; to copy the catalog call network_snapshot (one download replaces hundreds of pages). Results are slim summary rows; embed hero_photo_url as ⟨84 unchanged words⟩
{"additionalProperties":false,"allOf":[{"if":{"properties":{"sort":{"const":"distance"}},"required":["sort"]},"then":{"required":["latitude","longitude"]}}],"dependentRequired":{"latitude":["longitude"],"longitude":["latitude"],"radius_miles":["latitude","longitude"]},"description":"Categorical arrays are ORed within their field; separate filter fields are ANDed together. The default ordering is price_asc. Server-enforced: latitude requires longitude; longitude requires latitude; radius_miles requires latitude and longitude. sort = distance requires latitude and longitude. Additional argument rules are enforced server-side.","properties":{"body_style":{"oneOf": ⟨62 unchanged words⟩ ":1,"type":"array"}]},"format":{"default":"json","enum":["json","csv"]},"fuel_type":{"oneOf":[{"maxLength":80, ⟨46 unchanged words⟩ ,"type":"number"},"limit":{"description":"1–500 with view manifest; 1–50 for summary and full (server-enforced)","maximum":50500,"minimum":1,"type":"integer"}, ⟨317 unchanged words⟩ :120,"minLength":1,"type":"string"},"view":{"default":"summary","enum":["summary","manifest","full"]}},"type":"object"}
Sync catalog changes — State synchronization for a mirror built from network_snapshot: pass the sync_cursor and receive upserts (current rows in the same view) and tombstones since that position, with has_more and next_cursor. Bounded eventual consistency: take a fresh snapshot at least every 24 hours and whenever resync_required is true. Example: {"cursor": "<sync_cursor from network_snapshot>"}.
Compare a vehicle's price to like units — Price context for one vehicle against like units across the network (same make, model, exact model year, condition; optional trim and geo). Example: {"identity": "<VIN>", "rooftop_slug": "mms"} or {"make": "Subaru", "model": "Outback", "model_year": 2024, "condition": "used"}. Returns count, price quartiles, the subject's rank and up to 5 cheapest peers. Advertised prices only; call quote_preview for a total.
Export the catalog — Export the whole network catalog (or one rooftop with rooftop_slug) as one gzip artifact instead of paging: returns a descriptor with a generation URL, strong ETag, row and byte counts, expiry and (when available) sync_cursor; small results are inlined as rows_inline. Views: manifest (identity, pricing, key attributes; default), summary (the network_search row), full (the inventory_get row). Formats: csv (default), json. Example: {"view": "manifest", "format": "csv"}. Re-download only when the ETag changes; poll inventory_changes with sync_cursor to stay current.
⟨10 unchanged words⟩ then":{"required":["latitude","longitude","radius_miles"]}}],"dependentRequired":{"latitude":["longitude","radius_miles"],"longitude":["latitude","radius_miles"],"radius_miles":["latitude","longitude"]} ⟨419 unchanged words⟩ by rooftop and unit ids. distance requires latitude,and longitude,and(radius_milesradius_miles.defaults to 50).","enum":["price_asc","price_desc"," ⟨33 unchanged words⟩