{"openapi":"3.1.0","info":{"title":"fixapp public API","version":"1","summary":"Read-only catalogue and coverage for home-repair services in Israel. No token.","description":"fixapp connects people in Israel with vetted home-repair professionals. These endpoints need no token and name no professional. To search professionals, check availability or book for a customer, connect over MCP: the customer signs in with an SMS code and sets what the assistant may do. Docs: https://fixapp.co.il/developers. Catalogue as one file: https://fixapp.co.il/catalog.json.","contact":{"email":"support@fixapp.co.il","url":"https://fixapp.co.il/developers"}},"servers":[{"url":"https://fix-api.onrender.com/api/v1"}],"externalDocs":{"description":"Connect an AI assistant (MCP, OAuth 2.1)","url":"https://fixapp.co.il/developers"},"x-agent-access":{"mcp":"https://fix-api.onrender.com/api/v1/mcp","oauth_protected_resource":"https://fix-api.onrender.com/.well-known/oauth-protected-resource/api/v1/mcp","note":"Searching professionals, availability, price estimates and booking are MCP tools, used on behalf of a signed-in customer."},"paths":{"/public/directory":{"get":{"operationId":"getDirectory","summary":"Trades, their services, regions, and how many approved professionals serve each trade in each region.","responses":{"200":{"description":"The directory","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Directory"}}}}}}},"/public/coverage":{"get":{"operationId":"checkCoverage","summary":"Whether any professional for a trade serves a point or a region right now.","description":"Pass lat and lng, or a region code. Answers yes or no, never who. Limited to about 60 calls a minute per IP.","parameters":[{"name":"trade","in":"query","required":true,"schema":{"type":"string","example":"plumber"},"description":"A trade code from /public/directory."},{"name":"lat","in":"query","schema":{"type":"number","example":32.1848}},{"name":"lng","in":"query","schema":{"type":"number","example":34.8713}},{"name":"region","in":"query","schema":{"type":"string","enum":["north","haifa","sharon","gush_dan","jerusalem","south"]},"description":"Only when there is no point."}],"responses":{"200":{"description":"The answer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coverage"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests from this IP"}}}},"/trades":{"get":{"operationId":"listTrades","summary":"Every trade, with its id, code and names.","responses":{"200":{"description":"Trades","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Trade"}}}}}}}},"/trades/{id}/services":{"get":{"operationId":"listServices","summary":"The services under one trade.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The trade id from /trades."}],"responses":{"200":{"description":"Services","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Service"}}}}}}}},"/catalog/regions":{"get":{"operationId":"listRegions","summary":"The six service regions, north to south.","responses":{"200":{"description":"Regions","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Region"}}}}}}}},"/public/openapi.json":{"get":{"operationId":"getOpenApi","summary":"This document.","responses":{"200":{"description":"OpenAPI 3.1","content":{"application/json":{}}}}}}},"components":{"schemas":{"Region":{"type":"object","required":["code","name_he"],"properties":{"code":{"type":"string","enum":["north","haifa","sharon","gush_dan","jerusalem","south"]},"name_he":{"type":"string"}}},"Trade":{"type":"object","required":["id","code"],"properties":{"id":{"type":"string"},"code":{"type":"string"},"name_he":{"type":"string"},"name_en":{"type":"string"},"regulated":{"type":"boolean","description":"A licence is checked before the professional receives requests."}}},"Service":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name_he":{"type":"string"},"name_en":{"type":"string"}}},"Directory":{"type":"object","required":["regions","trades"],"properties":{"regions":{"type":"array","items":{"$ref":"#/components/schemas/Region"}},"trades":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name_he":{"type":"string"},"name_en":{"type":"string"},"regulated":{"type":"boolean"},"services":{"type":"array","items":{"type":"object","properties":{"name_he":{"type":"string"},"name_en":{"type":"string"}}}},"pros_by_region":{"type":"object","additionalProperties":{"type":"integer"},"description":"Approved, active professionals per region code; every region present, zero included."}}}}}},"Coverage":{"type":"object","required":["trade","region","covered","request_url","next_step"],"properties":{"trade":{"type":"string"},"region":{"type":["string","null"],"description":"The region the point falls in; null outside every region."},"covered":{"type":"boolean"},"request_url":{"type":"string","format":"uri","description":"Where the customer can send a request on the web."},"next_step":{"type":"string"}}},"Error":{"type":"object","properties":{"statusCode":{"type":"integer"},"message":{}}}}}}