{"openapi":"3.0.2","info":{"title":"Auto Body Shop Directory","version":"1.0.0","description":"Find auto body shops by ZIP code, city, location, or shop profile using AutoBodyShopNear.com directory data.","termsOfService":"https://autobodyshopnear.com/terms-of-service","contact":{"name":"Auto BodyShop Near","url":"https://autobodyshopnear.com/developers/body-shop-api","email":"hello@autobodyshopnear.com"}},"servers":[{"url":"https://autobodyshopnear.com/api/v1/public","description":"Public API v1"}],"externalDocs":{"description":"Developer documentation","url":"https://autobodyshopnear.com/developers/body-shop-api"},"tags":[{"name":"Shops","description":"Auto body shop directory endpoints"}],"paths":{"/":{"get":{"tags":["Shops"],"summary":"API index","operationId":"getApiIndex","responses":{"200":{"description":"API metadata and endpoint index","content":{"application/json":{"example":{"success":true,"data":{"name":"Auto Body Shop Directory","description":"Find auto body shops by ZIP code, city, location, or shop profile.","version":"1.0.0","website":"https://autobodyshopnear.com/developers/body-shop-api","terms":"https://autobodyshopnear.com/terms-of-service","openapi":"https://autobodyshopnear.com/developers/body-shop-api/openapi.json"}}}}}}}},"/shops/by-zip":{"get":{"tags":["Shops"],"summary":"Find shops by ZIP code","operationId":"getShopsByZip","parameters":[{"name":"zip","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{5}$"},"example":"90210"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Matching shops","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","required":["id","name","category","slug","profileUrl"],"properties":{"id":{"type":"integer","example":123456789},"name":{"type":"string","example":"Example Collision Center"},"category":{"type":"string","example":"Auto Body"},"city":{"type":"string","nullable":true,"example":"Houston"},"stateCode":{"type":"string","nullable":true,"example":"TX"},"postalCode":{"type":"string","nullable":true,"example":"77002"},"addressLine1":{"type":"string","nullable":true,"example":"100 Main St"},"phone":{"type":"string","nullable":true,"example":"(555) 123-4567"},"slug":{"type":"string","example":"example-collision-center-houston-tx-77002"},"profileUrl":{"type":"string","format":"uri","example":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}}}},"limit":{"type":"integer","example":20},"offset":{"type":"integer","example":0},"total":{"type":"integer","example":1},"hasMore":{"type":"boolean","example":false}}}}},"example":{"success":true,"data":{"items":[{"id":123456789,"name":"Example Collision Center","category":"Auto Body","city":"Houston","stateCode":"TX","postalCode":"77002","addressLine1":"100 Main St","phone":"(555) 123-4567","slug":"example-collision-center-houston-tx-77002","profileUrl":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}],"limit":20,"offset":0,"total":1,"hasMore":false}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string","example":"Invalid request parameters"},"code":{"type":"string","example":"VALIDATION_ERROR"}}}}},"example":{"success":false,"error":{"message":"Invalid request parameters","code":"VALIDATION_ERROR"}}}}}}}},"/shops/by-city":{"get":{"tags":["Shops"],"summary":"Find shops by city","operationId":"getShopsByCity","parameters":[{"name":"city","in":"query","required":true,"schema":{"type":"string"},"example":"Houston"},{"name":"state","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"},"example":"TX"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Matching shops","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","required":["id","name","category","slug","profileUrl"],"properties":{"id":{"type":"integer","example":123456789},"name":{"type":"string","example":"Example Collision Center"},"category":{"type":"string","example":"Auto Body"},"city":{"type":"string","nullable":true,"example":"Houston"},"stateCode":{"type":"string","nullable":true,"example":"TX"},"postalCode":{"type":"string","nullable":true,"example":"77002"},"addressLine1":{"type":"string","nullable":true,"example":"100 Main St"},"phone":{"type":"string","nullable":true,"example":"(555) 123-4567"},"slug":{"type":"string","example":"example-collision-center-houston-tx-77002"},"profileUrl":{"type":"string","format":"uri","example":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}}}},"limit":{"type":"integer","example":20},"offset":{"type":"integer","example":0},"total":{"type":"integer","example":1},"hasMore":{"type":"boolean","example":false}}}}},"example":{"success":true,"data":{"items":[{"id":123456789,"name":"Example Collision Center","category":"Auto Body","city":"Houston","stateCode":"TX","postalCode":"77002","addressLine1":"100 Main St","phone":"(555) 123-4567","slug":"example-collision-center-houston-tx-77002","profileUrl":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}],"limit":20,"offset":0,"total":1,"hasMore":false}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string","example":"Invalid request parameters"},"code":{"type":"string","example":"VALIDATION_ERROR"}}}}},"example":{"success":false,"error":{"message":"Invalid request parameters","code":"VALIDATION_ERROR"}}}}}}}},"/shops/nearby":{"get":{"tags":["Shops"],"summary":"Find nearby shops","operationId":"getNearbyShops","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90},"example":34.0522},{"name":"lng","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180},"example":-118.2437},{"name":"radiusMiles","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":200,"default":25}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"Nearby shops","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","required":["id","name","category","slug","profileUrl"],"properties":{"id":{"type":"integer","example":123456789},"name":{"type":"string","example":"Example Collision Center"},"category":{"type":"string","example":"Auto Body"},"city":{"type":"string","nullable":true,"example":"Houston"},"stateCode":{"type":"string","nullable":true,"example":"TX"},"postalCode":{"type":"string","nullable":true,"example":"77002"},"addressLine1":{"type":"string","nullable":true,"example":"100 Main St"},"phone":{"type":"string","nullable":true,"example":"(555) 123-4567"},"slug":{"type":"string","example":"example-collision-center-houston-tx-77002"},"profileUrl":{"type":"string","format":"uri","example":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}}}},"limit":{"type":"integer","example":20},"offset":{"type":"integer","example":0},"total":{"type":"integer","example":1},"hasMore":{"type":"boolean","example":false}}}}},"example":{"success":true,"data":{"items":[{"id":123456789,"name":"Example Collision Center","category":"Auto Body","city":"Houston","stateCode":"TX","postalCode":"77002","addressLine1":"100 Main St","phone":"(555) 123-4567","slug":"example-collision-center-houston-tx-77002","profileUrl":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002","distanceMiles":4.21}],"limit":20,"offset":0,"total":1,"hasMore":false}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string","example":"Invalid request parameters"},"code":{"type":"string","example":"VALIDATION_ERROR"}}}}},"example":{"success":false,"error":{"message":"Invalid request parameters","code":"VALIDATION_ERROR"}}}}}}}},"/shops/{slug}":{"get":{"tags":["Shops"],"summary":"Get a shop profile","operationId":"getShopBySlug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"example-collision-center-houston-tx-77002"}],"responses":{"200":{"description":"Shop profile","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","required":["id","name","category","slug","profileUrl"],"properties":{"id":{"type":"integer","example":123456789},"name":{"type":"string","example":"Example Collision Center"},"category":{"type":"string","example":"Auto Body"},"city":{"type":"string","nullable":true,"example":"Houston"},"stateCode":{"type":"string","nullable":true,"example":"TX"},"postalCode":{"type":"string","nullable":true,"example":"77002"},"addressLine1":{"type":"string","nullable":true,"example":"100 Main St"},"phone":{"type":"string","nullable":true,"example":"(555) 123-4567"},"slug":{"type":"string","example":"example-collision-center-houston-tx-77002"},"profileUrl":{"type":"string","format":"uri","example":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}}}}},"example":{"success":true,"data":{"id":123456789,"name":"Example Collision Center","category":"Auto Body","city":"Houston","stateCode":"TX","postalCode":"77002","addressLine1":"100 Main St","phone":"(555) 123-4567","slug":"example-collision-center-houston-tx-77002","profileUrl":"https://autobodyshopnear.com/shop/example-collision-center-houston-tx-77002"}}}}},"404":{"description":"Shop not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string","example":"Invalid request parameters"},"code":{"type":"string","example":"VALIDATION_ERROR"}}}}}}}}}}}}}