{"openapi":"3.1.0","info":{"title":"Obaflow API","version":"1.0.0","summary":"Read-only access to the Obaflow directory of verified coworking spaces across 21 countries.","description":"Public REST endpoints used by the Obaflow web app. For AI agent consumption, prefer the MCP server at /api/mcp which exposes the same data through a tool-calling interface (initialize → tools/list → tools/call).","contact":{"name":"Obaflow","url":"https://www.obaflow.com"},"license":{"name":"Proprietary — public read access only"}},"servers":[{"url":"https://www.obaflow.com"}],"paths":{"/api/spaces":{"get":{"summary":"List spaces","description":"Paginated list of all active coworking spaces. Use query params to filter by country / city / capacity. Sorted by Google rating descending by default.","parameters":[{"name":"country","in":"query","schema":{"type":"string","maxLength":2}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"capacity_min","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Spaces array","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Space"}}}}}}}},"/api/spaces/{slug}":{"get":{"summary":"Get a single space","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Space detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpaceDetail"}}}},"404":{"description":"Not found"}}}},"/api/spaces/search":{"get":{"summary":"Free-text search","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"country","in":"query","schema":{"type":"string","maxLength":2}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Space"}}}}}}}}},"components":{"schemas":{"Space":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"city":{"type":"string","nullable":true},"country_code":{"type":"string","nullable":true,"maxLength":2},"neighborhood":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"price_month_min":{"type":"number","nullable":true},"price_day_min":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"google_rating":{"type":"number","nullable":true},"google_reviews_count":{"type":"integer","nullable":true},"capacity_min":{"type":"integer","nullable":true},"capacity_max":{"type":"integer","nullable":true},"is_premium":{"type":"boolean"},"is_verified":{"type":"boolean"}},"required":["slug","name"]},"SpaceDetail":{"allOf":[{"$ref":"#/components/schemas/Space"},{"type":"object","properties":{"description":{"type":"string","nullable":true},"amenities":{"type":"array","items":{"type":"string"}},"opening_hours":{"type":"array","items":{"type":"object"}},"photos":{"type":"array","items":{"type":"string","format":"uri"}}}}]}}},"x-mcp-server":{"description":"Obaflow also exposes an MCP server at /api/mcp for AI agent consumption.","url":"https://www.obaflow.com/api/mcp","tools":["list_cities","get_city","list_spaces_in_city","get_space","search_spaces"]}}