{"openapi":"3.1.0","info":{"title":"Storingenoverzicht API","version":"1.1.0","description":"Meldingen van gebruikers over storingen bij Nederlandse diensten. Een storing is: veel meer meldingen dan normaal voor die dienst. Historie vanaf 30 april 2026.","termsOfService":"https://storingenoverzicht.nl/api/voorwaarden"},"servers":[{"url":"https://storingenoverzicht.nl/api/v1"}],"security":[{"sleutel":[]},{"bearer":[]}],"components":{"securitySchemes":{"sleutel":{"type":"apiKey","in":"header","name":"X-API-Key"},"bearer":{"type":"http","scheme":"bearer"}},"responses":{"Fout":{"description":"Fout","content":{"application/json":{"schema":{"type":"object","properties":{"fout":{"type":"object","properties":{"code":{"type":"string"},"bericht":{"type":"string"},"documentatie":{"type":"string"}}}}}}}}}},"paths":{"/status":{"get":{"summary":"Status van alle of een keuze aan bedrijven","parameters":[{"name":"bedrijven","in":"query","required":false,"description":"Komma-lijst van adressen","schema":{"type":"string"}},{"name":"categorie","in":"query","required":false,"description":"Adres van een categorie of hoofdcategorie","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Komma-lijst: storing, verhoogd, rustig, onbekend","schema":{"type":"string"}}],"responses":{"200":{"description":"Status","content":{"application/json":{}}},"304":{"description":"Niet veranderd (If-None-Match)"},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/status/{bedrijf}":{"get":{"summary":"Status van één bedrijf","parameters":[{"name":"bedrijf","in":"path","required":true,"description":"Adres van het bedrijf, zoals in /storing/<adres>; \"voorbeeld\" is de demodienst.","schema":{"type":"string"}}],"responses":{"200":{"description":"Status","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/bedrijven":{"get":{"summary":"Bedrijven, met filters en een cursor","parameters":[{"name":"q","in":"query","required":false,"description":"Zoek op naam of adres","schema":{"type":"string"}},{"name":"categorie","in":"query","required":false,"description":"Adres van een categorie","schema":{"type":"string"}},{"name":"soort","in":"query","required":false,"description":"Soort overheid, bijvoorbeeld Gemeente","schema":{"type":"string"}},{"name":"statuspagina","in":"query","required":false,"description":"ja: alleen met een officiële statuspagina","schema":{"type":"string"}},{"name":"aantal","in":"query","required":false,"description":"1 tot 1000, standaard 100","schema":{"type":"integer"}},{"name":"na","in":"query","required":false,"description":"De waarde van volgende uit het vorige antwoord","schema":{"type":"string"}}],"responses":{"200":{"description":"Bedrijven","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/bedrijven/{bedrijf}":{"get":{"summary":"Eén bedrijf met status","parameters":[{"name":"bedrijf","in":"path","required":true,"description":"Adres van het bedrijf, zoals in /storing/<adres>; \"voorbeeld\" is de demodienst.","schema":{"type":"string"}}],"responses":{"200":{"description":"Bedrijf","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/bedrijven/{bedrijf}/meldingen":{"get":{"summary":"Meldingen in een reeks","description":"Gratis: de laatste 24 uur. Zakelijk: alles vanaf 30 april 2026.","parameters":[{"name":"bedrijf","in":"path","required":true,"description":"Adres van het bedrijf, zoals in /storing/<adres>; \"voorbeeld\" is de demodienst.","schema":{"type":"string"}},{"name":"per","in":"query","required":false,"description":"kwartier, uur of dag","schema":{"type":"string"}},{"name":"van","in":"query","required":false,"description":"ISO 8601","schema":{"type":"string"}},{"name":"tot","in":"query","required":false,"description":"ISO 8601","schema":{"type":"string"}},{"name":"uitsplitsen","in":"query","required":false,"description":"soort of provincie","schema":{"type":"string"}}],"responses":{"200":{"description":"Reeks","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/categorieen":{"get":{"summary":"Categorieën met aantallen","responses":{"200":{"description":"Categorieën","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/storingen":{"get":{"summary":"Storingen, nieuwste eerst","description":"Gratis: de laatste 7 dagen. Zakelijk: alles vanaf 30 april 2026.","parameters":[{"name":"van","in":"query","required":false,"description":"ISO 8601","schema":{"type":"string"}},{"name":"tot","in":"query","required":false,"description":"ISO 8601","schema":{"type":"string"}},{"name":"bedrijf","in":"query","required":false,"description":"Komma-lijst van adressen","schema":{"type":"string"}},{"name":"categorie","in":"query","required":false,"description":"Adres van een categorie","schema":{"type":"string"}},{"name":"actief","in":"query","required":false,"description":"ja: alleen lopende","schema":{"type":"string"}},{"name":"aantal","in":"query","required":false,"description":"1 tot 500","schema":{"type":"integer"}},{"name":"na","in":"query","required":false,"description":"Cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"Storingen","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/storingen/{id}":{"get":{"summary":"Eén storing met meldingen per kwartier en officiële berichten","parameters":[{"name":"id","in":"path","required":true,"description":"Id van de storing","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Storing","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/berichten":{"get":{"summary":"Officiële berichten en gepland onderhoud (zakelijk)","parameters":[{"name":"bedrijf","in":"query","required":false,"description":"Komma-lijst van adressen","schema":{"type":"string"}},{"name":"soort","in":"query","required":false,"description":"storing, onderhoud of info","schema":{"type":"string"}}],"responses":{"200":{"description":"Berichten","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}},"/gebruik":{"get":{"summary":"Je eigen verbruik en limiet (telt niet mee)","responses":{"200":{"description":"Gebruik","content":{"application/json":{}}},"401":{"$ref":"#/components/responses/Fout"},"402":{"$ref":"#/components/responses/Fout"},"404":{"$ref":"#/components/responses/Fout"},"429":{"$ref":"#/components/responses/Fout"}}}}}}