IMGW-PIB Public Data API

What you can build

• Pause dispatch in counties under a wind warning

  warningsmeteo lists each event with stopien, its window and a teryt list. The operator matches teryt to your delivery counties and proposes pausing runs there until obowiazuje_do.

  With Weather Hold

• Check freeze protection on a cold night

  synop gives hourly temperatura per station. When the reading nearest a site falls below your threshold, the operator proposes the freeze checklist and records the station and hour.

  With Freeze Protection

• Watch river stages near a property

  hydro returns stan_wody with the gauge's own stan_ostrzegawczy and stan_alarmowy. When a nearby gauge crosses the warning level, the operator proposes flood preparation for that property.

  With Storm Prep

• Send hydrological warnings to the right sites

  warningshydro carries obszary with wojewodztwo and kod_zlewni. The operator maps catchment codes to sites and drafts the notice, which goes out once you approve.

  With Severe Weather Notice

Requirements

• Station ids or diacritic-free names for the synop stations near your sites, and station coordinates from the meteo and hydro rows
• TERYT county codes for your sites, to match the teryt list on meteorological warnings
• The line 'Źródłem pochodzenia danych jest Instytut Meteorologii i Gospodarki Wodnej – Państwowy Instytut Badawczy' on any product built from the data
• A signed agreement with IMGW-PIB (biznes@imgw.pl) for business use of core-network data outside the high-value datasets

Authentication

None. The endpoints under danepubliczne.imgw.pl/api/data are open HTTP GETs without a key; using the service is acceptance of the Regulamin udostępniania danych.

Limits

• No update frequency is documented; each reading carries its own timestamp and there is no push channel
• Values arrive as strings or null, and many automatic stations report only some elements at a given time
• Part of the data is published unchecked when that is the form IMGW-PIB holds at the time (§ 6 of the Regulamin)
• Free use covers private purposes and high-value datasets; other business use of core-network data requires an agreement

Questions and answers

Can I use IMGW-PIB data for business purposes?

Under § 5 of the Regulamin, data is free for private purposes and, for high-value datasets defined by Regulation (EU) 2023/138, for any purpose. Business use of data from the core measurement network and forecast offices requires a signed agreement covering network costs. Requests go to biznes@imgw.pl.

How are warnings tied to places?

Meteorological warnings carry a teryt array of county codes, with obowiazuje_od and obowiazuje_do for the window and the issuing biuro. Hydrological warnings carry obszary, each with a wojewodztwo, an opis, and kod_zlewni catchment codes. Join those codes to your own site list.

What attribution is required?

Every work or product built with the data must state 'Źródłem pochodzenia danych jest Instytut Meteorologii i Gospodarki Wodnej – Państwowy Instytut Badawczy'. If you process the data, add 'Dane Instytutu Meteorologii i Gospodarki Wodnej – Państwowego Instytutu Badawczego zostały przetworzone'.