{"openapi":"3.1.0","info":{"title":"CarTruvo public inventory","version":"1.0.0","description":"Read-only access to available public vehicle listings. Seller facts are not independently verified. Contact sellers through the listing. Follow all feed pages before replacing a local catalog, recheck availability, and remove missing/expired records. No account, contact, message or payment access.","contact":{"name":"CarTruvo","email":"hello@cartruvo.com"}},"servers":[{"url":"https://cartruvo.com"}],"paths":{"/api/public/inventory":{"get":{"operationId":"searchVehicles","summary":"Find currently available vehicles","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"make","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":50}},{"name":"model","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":60}},{"name":"city","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"state","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z]{2}$"}},{"name":"minYear","in":"query","required":false,"schema":{"type":"integer","minimum":1900,"maximum":2100}},{"name":"maxYear","in":"query","required":false,"schema":{"type":"integer","minimum":1900,"maximum":2100}},{"name":"minPrice","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10000000}},{"name":"maxPrice","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10000000}},{"name":"maxMileage","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":2000000}},{"name":"bodyType","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":40,"description":"Exact listing body style: Sedan, SUV / Crossover, Truck, Coupe / Convertible, Hatchback / Wagon, Van / Minivan, or Other."}},{"name":"fuelType","in":"query","required":false,"schema":{"type":"string","enum":["Gasoline","Diesel","Electric","Hybrid","Plug-in hybrid","Flex fuel","Other"]}},{"name":"transmission","in":"query","required":false,"schema":{"type":"string","enum":["Automatic","Manual","Other"]}},{"name":"drivetrain","in":"query","required":false,"schema":{"type":"string","enum":["FWD","RWD","AWD","4WD"]}},{"name":"sellerType","in":"query","required":false,"schema":{"type":"string","enum":["Private seller","Dealership"]}},{"name":"sort","in":"query","required":false,"schema":{"default":"newest","type":"string","enum":["newest","price_asc","mileage_asc"]}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":900}}],"responses":{"200":{"description":"Current public inventory, checked for this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryPage"}}}},"400":{"description":"Invalid filters or expired/mismatched pagination cursor."},"429":{"description":"Rate limited. Retry after the Retry-After interval."},"503":{"description":"Public inventory is temporarily disabled or unavailable."}}}},"/api/public/inventory/{id}":{"get":{"operationId":"getVehicle","summary":"Recheck one available vehicle","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Current public inventory, checked for this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleResult"}}}},"400":{"description":"Invalid filters or expired/mismatched pagination cursor."},"404":{"description":"Listing unavailable, whether missing or private."},"429":{"description":"Rate limited. Retry after the Retry-After interval."},"503":{"description":"Public inventory is temporarily disabled or unavailable."}}}},"/feeds/inventory.json":{"get":{"operationId":"getInventoryFeed","summary":"Read a page of the live JSON inventory feed","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":900}}],"responses":{"200":{"description":"Current public inventory, checked for this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryPage"}}}},"400":{"description":"Invalid filters or expired/mismatched pagination cursor."},"429":{"description":"Rate limited. Retry after the Retry-After interval."},"503":{"description":"Public inventory is temporarily disabled or unavailable."}}}},"/feeds/inventory.csv":{"get":{"operationId":"getInventoryCsv","summary":"Download a page of the live CSV feed; follow the Link response header","parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":900}}],"responses":{"200":{"description":"RFC 4180 CSV. Formula-like cells are prefixed with an apostrophe. Link rel=next and X-Has-More describe pagination.","content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Invalid filters or expired/mismatched pagination cursor."},"429":{"description":"Rate limited. Retry after the Retry-After interval."},"503":{"description":"Public inventory is temporarily disabled or unavailable."}}}}},"components":{"schemas":{"InventoryPage":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"checkedAt":{"type":"string"},"snapshotStartedAt":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"openUrl":{"type":"string"},"contactUrl":{"type":"string"},"availability":{"type":"string","const":"available"},"price":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","const":"USD"}},"required":["amount","currency"]},"year":{"type":"number"},"make":{"type":"string"},"model":{"type":"string"},"trim":{"type":"string"},"vin":{"type":"string"},"mileage":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","const":"mi"}},"required":["value","unit"]},"location":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string","const":"US"}},"required":["city","state","country"]},"seller":{"type":"object","properties":{"type":{"type":"string","enum":["Private seller","Dealership","Not specified"]},"dealershipName":{"type":"string"}},"required":["type"]},"specifications":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"disclosures":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"description":{"type":"string"},"passport":{"type":"array","items":{"type":"object","properties":{"topic":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"}},"required":["topic","title","text"]}},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"alt":{"type":"string"}},"required":["url","alt"]}},"listedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"source":{"type":"string","const":"CarTruvo"},"factsReportedBy":{"type":"string","const":"seller"},"checkedAt":{"type":"string"}},"required":["id","title","url","openUrl","contactUrl","availability","price","year","make","model","trim","vin","mileage","location","seller","specifications","disclosures","description","passport","images","listedAt","updatedAt","expiresAt","source","factsReportedBy","checkedAt"]}},"nextCursor":{"type":["string","null"]},"nextUrl":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["schemaVersion","checkedAt","snapshotStartedAt","items","nextCursor","nextUrl","hasMore"]},"VehicleResult":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"checkedAt":{"type":"string"},"vehicle":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"openUrl":{"type":"string"},"contactUrl":{"type":"string"},"availability":{"type":"string","const":"available"},"price":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","const":"USD"}},"required":["amount","currency"]},"year":{"type":"number"},"make":{"type":"string"},"model":{"type":"string"},"trim":{"type":"string"},"vin":{"type":"string"},"mileage":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","const":"mi"}},"required":["value","unit"]},"location":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string","const":"US"}},"required":["city","state","country"]},"seller":{"type":"object","properties":{"type":{"type":"string","enum":["Private seller","Dealership","Not specified"]},"dealershipName":{"type":"string"}},"required":["type"]},"specifications":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"disclosures":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"description":{"type":"string"},"passport":{"type":"array","items":{"type":"object","properties":{"topic":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"}},"required":["topic","title","text"]}},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"alt":{"type":"string"}},"required":["url","alt"]}},"listedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"source":{"type":"string","const":"CarTruvo"},"factsReportedBy":{"type":"string","const":"seller"},"checkedAt":{"type":"string"}},"required":["id","title","url","openUrl","contactUrl","availability","price","year","make","model","trim","vin","mileage","location","seller","specifications","disclosures","description","passport","images","listedAt","updatedAt","expiresAt","source","factsReportedBy","checkedAt"]}},"required":["schemaVersion","checkedAt","vehicle"]}}}}