{"openapi":"3.1.0","info":{"title":"x402 Used Car QuickCheck","description":"Agent-ready used-car valuation and purchase intelligence with x402 payments on Base and Solana Mainnet.","version":"3.0.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Root  Get"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/car-check":{"get":{"summary":"Fast used-car price and deal analysis","description":"Evaluate a used car before purchase. Compares the asking price with up to 50 current dealer listings in Canada or the U.S., matched by year, make, model, mileage and optional trim/location. Returns robust median and quartile pricing, deal rating, confidence, sample size and risk flags. Use for fast used-car price checks.","operationId":"car_check_car_check_get","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"title":"Make"}},{"name":"model","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"title":"Model"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2030,"minimum":1980,"title":"Year"}},{"name":"mileage","in":"query","required":true,"schema":{"type":"integer","maximum":1500000,"minimum":0,"title":"Mileage"}},{"name":"price","in":"query","required":true,"schema":{"type":"number","maximum":10000000,"exclusiveMinimum":0,"title":"Price"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(CA|US|ca|us)$","default":"CA","title":"Country"}},{"name":"trim","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Trim"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"State"}},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"City"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Car Check Car Check Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Fast used-car price and deal analysis from a direct JSON body","description":"Evaluate a used car before purchase. Compares the asking price with up to 50 current dealer listings in Canada or the U.S., matched by year, make, model, mileage and optional trim/location. Returns robust median and quartile pricing, deal rating, confidence, sample size and risk flags. Use for fast used-car price checks.","operationId":"post_car_check_car_check_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarCheckRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Car Check Car Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/deep-check":{"get":{"summary":"Advanced used-car purchase intelligence and negotiation recommendation","description":"Used Car DeepCheck is an AI-ready pre-purchase used car valuation, vehicle pricing, and deal analysis API for buyers and agents. Use it before buying a used car to check if the asking price is fair, compare live dealer listings, estimate market value, fair value, negotiation target, and maximum buy price, then return BUY, NEGOTIATE, or WALK AWAY. Supports Canada and U.S. markets with optional VIN, mileage, trim, location, listing history, and market-turnover intelligence.","operationId":"deep_check_deep_check_get","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"title":"Make"}},{"name":"model","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"title":"Model"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2030,"minimum":1980,"title":"Year"}},{"name":"mileage","in":"query","required":true,"schema":{"type":"integer","maximum":1500000,"minimum":0,"title":"Mileage"}},{"name":"price","in":"query","required":true,"schema":{"type":"number","maximum":10000000,"exclusiveMinimum":0,"title":"Price"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(CA|US|ca|us)$","default":"CA","title":"Country"}},{"name":"trim","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Trim"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"State"}},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"City"}},{"name":"zip","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":12},{"type":"null"}],"title":"Zip"}},{"name":"vin","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":17,"maxLength":17},{"type":"null"}],"title":"Vin"}},{"name":"dealer_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(independent|franchise)$","default":"independent","title":"Dealer Type"}},{"name":"is_certified","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Is Certified"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Deep Check Deep Check Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Advanced used-car purchase intelligence from a direct JSON body","description":"Used Car DeepCheck is an AI-ready pre-purchase used car valuation, vehicle pricing, and deal analysis API for buyers and agents. Use it before buying a used car to check if the asking price is fair, compare live dealer listings, estimate market value, fair value, negotiation target, and maximum buy price, then return BUY, NEGOTIATE, or WALK AWAY. Supports Canada and U.S. markets with optional VIN, mileage, trim, location, listing history, and market-turnover intelligence.","operationId":"post_deep_check_deep_check_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeepCheckRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Deep Check Deep Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CarCheckRequest":{"properties":{"make":{"type":"string","maxLength":60,"minLength":1,"title":"Make"},"model":{"type":"string","maxLength":80,"minLength":1,"title":"Model"},"year":{"type":"integer","maximum":2030.0,"minimum":1980.0,"title":"Year"},"mileage":{"type":"integer","maximum":1500000.0,"minimum":0.0,"title":"Mileage"},"price":{"type":"number","maximum":10000000.0,"exclusiveMinimum":0.0,"title":"Price"},"country":{"type":"string","pattern":"^(CA|US|ca|us)$","title":"Country","default":"CA"},"trim":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Trim"},"state":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"State"},"city":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"City"}},"additionalProperties":false,"type":"object","required":["make","model","year","mileage","price"],"title":"CarCheckRequest","description":"Direct JSON body accepted by POST /car-check."},"DeepCheckRequest":{"properties":{"make":{"type":"string","maxLength":60,"minLength":1,"title":"Make"},"model":{"type":"string","maxLength":80,"minLength":1,"title":"Model"},"year":{"type":"integer","maximum":2030.0,"minimum":1980.0,"title":"Year"},"mileage":{"type":"integer","maximum":1500000.0,"minimum":0.0,"title":"Mileage"},"price":{"type":"number","maximum":10000000.0,"exclusiveMinimum":0.0,"title":"Price"},"country":{"type":"string","pattern":"^(CA|US|ca|us)$","title":"Country","default":"CA"},"trim":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Trim"},"state":{"anyOf":[{"type":"string","maxLength":3},{"type":"null"}],"title":"State"},"city":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"City"},"zip":{"anyOf":[{"type":"string","maxLength":12},{"type":"null"}],"title":"Zip"},"vin":{"anyOf":[{"type":"string","maxLength":17,"minLength":17},{"type":"null"}],"title":"Vin"},"dealer_type":{"type":"string","pattern":"^(independent|franchise)$","title":"Dealer Type","default":"independent"},"is_certified":{"type":"boolean","title":"Is Certified","default":false}},"additionalProperties":false,"type":"object","required":["make","model","year","mileage","price"],"title":"DeepCheckRequest","description":"Direct JSON body accepted by POST /deep-check."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}