{"openapi":"3.1.0","info":{"title":"MLWerks Vehicle Resolution API","description":"VIN / year-make-model-trim resolution to trim-level physical dimensions with provenance. Never fabricates a value: every dimension is sourced, or null with a reason.","version":"0.1.0"},"paths":{"/v1/vehicles/by-vin/{vin}":{"get":{"summary":"By Vin","operationId":"by_vin_v1_vehicles_by_vin__vin__get","parameters":[{"name":"vin","in":"path","required":true,"schema":{"type":"string","title":"Vin"}},{"name":"units","in":"query","required":false,"schema":{"enum":["us","metric","both"],"type":"string","default":"both","title":"Units"}},{"name":"trim_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vehicles/by-ymmt":{"get":{"summary":"By Ymmt","operationId":"by_ymmt_v1_vehicles_by_ymmt_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","title":"Year"}},{"name":"make","in":"query","required":true,"schema":{"type":"string","title":"Make"}},{"name":"model","in":"query","required":true,"schema":{"type":"string","title":"Model"}},{"name":"trim_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trim Id"}},{"name":"cab","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cab"}},{"name":"box","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Box"}},{"name":"drive","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Drive"}},{"name":"rear_axle","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rear Axle"}},{"name":"roof","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roof"}},{"name":"length_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Length Class"}},{"name":"body","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"}},{"name":"units","in":"query","required":false,"schema":{"enum":["us","metric","both"],"type":"string","default":"both","title":"Units"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/years":{"get":{"summary":"Years","operationId":"years_v1_catalog_years_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/catalog/{year}/makes":{"get":{"summary":"Makes","operationId":"makes_v1_catalog__year__makes_get","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"integer","title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/{year}/{make}/models":{"get":{"summary":"Models","operationId":"models_v1_catalog__year___make__models_get","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"integer","title":"Year"}},{"name":"make","in":"path","required":true,"schema":{"type":"string","title":"Make"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/{year}/{make}/{model}/trims":{"get":{"summary":"Trims","operationId":"trims_v1_catalog__year___make___model__trims_get","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"integer","title":"Year"}},{"name":"make","in":"path","required":true,"schema":{"type":"string","title":"Make"}},{"name":"model","in":"path","required":true,"schema":{"type":"string","title":"Model"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vehicles/{trim_id}/compare":{"post":{"summary":"Compare","description":"Field measurements vs OEM baseline. Flags deviations beyond tolerance; never edits the baseline.","operationId":"compare_v1_vehicles__trim_id__compare_post","parameters":[{"name":"trim_id","in":"path","required":true,"schema":{"type":"string","title":"Trim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Measurements"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vehicles/batch":{"post":{"summary":"Batch","operationId":"batch_v1_vehicles_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dataset":{"get":{"summary":"Dataset","operationId":"dataset_v1_dataset_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/readyz":{"get":{"summary":"Readyz","operationId":"readyz_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"BatchReq":{"properties":{"vins":{"items":{"type":"string"},"type":"array","maxItems":500,"title":"Vins"},"units":{"type":"string","enum":["us","metric","both"],"title":"Units","default":"both"}},"type":"object","required":["vins"],"title":"BatchReq"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Measure":{"properties":{"in":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"In"},"mm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mm"},"lb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lb"},"kg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Kg"},"provenance":{"type":"string","title":"Provenance"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["provenance"],"title":"Measure"},"Measurements":{"properties":{"length_in":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Length In"},"width_in":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Width In"},"height_in":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Height In"},"weight_lb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weight Lb"},"tolerance_in":{"type":"number","title":"Tolerance In","default":2.0},"tolerance_lb":{"type":"number","title":"Tolerance Lb","default":150.0}},"type":"object","title":"Measurements"},"ResolveResponse":{"properties":{"resolution":{"type":"string","enum":["resolved","ambiguous","partial","failed"],"title":"Resolution"},"confidence":{"type":"number","title":"Confidence"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"input":{"additionalProperties":true,"type":"object","title":"Input"},"vehicle":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Vehicle"},"dimensions":{"additionalProperties":{"$ref":"#/components/schemas/Measure"},"type":"object","title":"Dimensions","default":{}},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates","default":[]},"distinguishing":{"items":{"type":"string"},"type":"array","title":"Distinguishing","default":[]},"dropped_hints":{"items":{"type":"string"},"type":"array","title":"Dropped Hints","default":[]},"dataset_version":{"type":"string","title":"Dataset Version"}},"type":"object","required":["resolution","confidence","input","dataset_version"],"title":"ResolveResponse"},"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"}}}}