{"info":{"title":"Boinsikt API","description":"Strukturerad data om svenska bostadsrättsföreningar: nyckeltal, Boinsikt-score, byggnader, lån, styrelse, dokument.","version":"1.0"},"components":{"securitySchemes":{"ApiKeyAuth":{"in":"header","type":"apiKey","name":"X-API-Key"}}},"openapi":"3.1.0","servers":[{"url":"https://boinsikt.com/api"}],"paths":{"/brf/{orgNumber}/nearby":{"get":{"summary":"Närmaste föreningar","operationId":"getNearby","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}}}},"/brf/{orgNumber}/documents":{"get":{"summary":"Arkiverade dokument","operationId":"getDocuments","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}}}},"/reports/{orgNumber}":{"get":{"summary":"Köpt rapport: nyckeltal, sammanfattning, styrkor, risker","operationId":"getReport","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}},"security":[{"ApiKeyAuth":[]}]}},"/reports/{orgNumber}/details":{"get":{"summary":"Byggnader, försäljningar, annonser","operationId":"getReportDetails","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}},"security":[{"ApiKeyAuth":[]}]}},"/brf/search":{"get":{"summary":"Sök förening på namn eller org.nr","operationId":"searchBrf","parameters":[{"name":"q","description":"Sökterm (minst 2 tecken)","schema":{"type":"string"},"required":true,"in":"query"},{"name":"limit","description":"Max träffar","schema":{"type":"string"},"required":false,"in":"query"}],"responses":{"200":{"description":"OK"}}}},"/reports/{orgNumber}/full":{"get":{"summary":"Hela extraherade årsredovisningen (JSON)","operationId":"getReportFull","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}},"security":[{"ApiKeyAuth":[]}]}},"/brf/{orgNumber}":{"get":{"summary":"Publik översikt (score, energiklass, år)","operationId":"getBrf","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}}}},"/brf/{orgNumber}/addresses":{"get":{"summary":"Gatuadresser i fastigheten","operationId":"getAddresses","parameters":[{"name":"orgNumber","description":"Organisationsnummer, t.ex. 769607-5774","schema":{"type":"string"},"required":true,"in":"path"}],"responses":{"200":{"description":"OK"}}}}}}