KNMI

Publieke GraphQL-queries: KNMI.

Endpoint: POST https://graphql.persmonitor.nl/graphql

---

knmiColorCodes

KNMI waarschuwingsniveaus (code geel/oranje/rood) voor knmi_weather-monitors.

Return type: [MonitorReferenceItem!]!

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query KnmiColorCodes {
  knmiColorCodes {
    # selecteer velden uit het return type
  }
}

---

knmiGeneral

Landelijke KNMI-waarschuwingen (general). Voor 112Hub homepage. Null als nog geen data.

Return type: KnmiRegionDetail

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query KnmiGeneral {
  knmiGeneral {
    # selecteer velden uit het return type
  }
}

---

knmiLatestObservation

Laatste weersobservatie (10-min EDR, standaard De Bilt). Null als nog geen data (voer knmi:sync-observations uit).

Return type: KnmiObservation

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
stationId	String	Nee	EDR location id. Null = standaardstation (De Bilt).

Voorbeeld:

query KnmiLatestObservation(
  $stationId: String
) {
  knmiLatestObservation(stationId: $stationId) {
    # selecteer velden uit het return type
  }
}

---

knmiObservationHistory

Historie weersobservaties voor een station (voor grafieken/stats).

Return type: [KnmiObservation]!

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
stationId	String!	Ja	EDR location id (bijv. 0-20000-0-06260 voor De Bilt).
fromTs	Int!	Ja	Start Unix timestamp.
toTs	Int!	Ja	Eind Unix timestamp.
limit	Int	Nee	Max aantal observaties (default 1000).

Voorbeeld:

query KnmiObservationHistory(
  $limit: Int
) {
  knmiObservationHistory(stationId: $stationId, fromTs: $fromTs, toTs: $toTs) {
    # selecteer velden uit het return type
  }
}

---

knmiRegionDetail

Volledige KNMI-detail voor één regio (waarschuwingen met periodes). Voor 112Hub detailpagina.

Return type: KnmiRegionDetail

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
code	String!	Ja	Regiocode (bijv. noord-holland, limburg).

Voorbeeld:

query KnmiRegionDetail {
  knmiRegionDetail(code: $code) {
    # selecteer velden uit het return type
  }
}

---

knmiRegionDetails

Alle KNMI-regio’s met volledige detail (waarschuwingen, periodes). Voor 112Hub of bulk-export.

Return type: [KnmiRegionDetail]!

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query KnmiRegionDetails {
  knmiRegionDetails {
    # selecteer velden uit het return type
  }
}

---

knmiRegions

Lijst van alle KNMI-regio’s (12 provincies) met actuele status.

Return type: [KnmiRegion]!

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query KnmiRegions {
  knmiRegions {
    # selecteer velden uit het return type
  }
}

---

knmiSnapshot

Snapshot van alle KNMI-regio’s op een kalenderdag (YYYY-MM-DD, Europe/Amsterdam). Vandaag = live actuele data; anders = stand aan einde van die dag (laatste event ≤ 23:59:59).

Return type: [KnmiRegionDetail]!

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
date	String!	Ja	Kalenderdag YYYY-MM-DD (Europe/Amsterdam).

Voorbeeld:

query KnmiSnapshot {
  knmiSnapshot(date: $date) {
    # selecteer velden uit het return type
  }
}

---

knmiStatsAvailableYears

Jaren waarin ten minste één KNMI waarschuwings-event bestaat. Voor dropdown op statistiekenpagina.

Return type: [Int]!

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query KnmiStatsAvailableYears {
  knmiStatsAvailableYears {
    # selecteer velden uit het return type
  }
}

---

knmiStatsMonthly

Maandelijkse statistieken: per maand het aantal hele dagen per waarschuwingsniveau. Een dag telt als het hoogste niveau dat die dag actief was.

Return type: [KnmiMonthlyStats]!

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
regionCode	String	Nee	Regiocode (bijv. noord-holland). Null = alle regio's gecombineerd (totaal).
year	Int!	Ja	Jaar (bijv. 2025).

Voorbeeld:

query KnmiStatsMonthly(
  $regionCode: String
) {
  knmiStatsMonthly(regionCode: $regionCode, year: $year) {
    # selecteer velden uit het return type
  }
}

---

knmiWarningEventsForMonitor

KNMI-waarschuwingsevents die door het filter van een knmi_weather-monitor komen (regio + kleurcode).

Return type: [KnmiWarningEvent!]!

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
monitor	MonitorRef!	Ja
first	Int	Nee (default: 20)	Max aantal (1–200).
page	Int	Nee (default: 1)

Voorbeeld:

query KnmiWarningEventsForMonitor(
  $first: Int
  $page: Int
) {
  knmiWarningEventsForMonitor(monitor: $monitor, first: $first, page: $page) {
    # selecteer velden uit het return type
  }
}

---