uRADMonitor Login

uRADMonitor › Open data

Open environmental data and API

811 sensors online in 43 countries · data since 2000 · CC BY 4.0

Every uRADMonitor station publishes its measurements to an open network. You can read the data on the live map, download it as CSV or JSON from the dashboard, embed it on your website, or query it through the REST API. The data is free to use under the Creative Commons Attribution 4.0 license.

Ways to use the data

Authentication

Create a free account, log in to the dashboard and open the API tab. It shows your user ID and your user key. Send them with every call as two HTTP headers:

X-User-id: YOUR_USER_ID
X-User-hash: YOUR_USER_KEY

Your account sees the units you own and the units you were given access to. All calls use HTTPS and return JSON. Errors come back as {"error": "..."}.

Endpoints

Base URL: https://data.uradmonitor.com/api/v1/

CallReturns
GET /devicesYour units, with the latest value (last_XX), a moving average of the latest readings (avg_XX) and the name and unit (param_XX) of every sensor, plus location, status, firmware, hardware and AQI.
GET /devices/{id}The sensors of one unit, with names and units.
GET /devices/{id}/{sensor}Readings of one sensor over the last 24 hours.
GET /devices/{id}/{sensor}/{start}/{stop}Readings between start and stop, given in seconds before now (stop is optional). Use all for every sensor, all-raw for every sensor without compensation, and last as start for the latest record only. Maximum span: 60 days for one sensor, 1 day for all.
GET /devices/{id}/average/{start}/{stop}Daily minimum, maximum and average of every parameter, up to 120 days.

Example, PM2.5 from one unit over the last hour:

curl -H "X-User-id: YOUR_USER_ID" -H "X-User-hash: YOUR_USER_KEY" \
  https://data.uradmonitor.com/api/v1/devices/82000466/pm25/3600

Best practice: read /devices once and use the last_XX fields. Request time series only for the units and intervals you need.

Unit fields

FieldMeaning
idUnique unit ID (8 hex digits). The first byte identifies the model.
timefirst, timelastUnix time of the first and of the latest upload.
timelocalSeconds since the unit last restarted.
latitude, longitude, altitude, speedPosition. Units set to "randomise" by their owner show slightly shifted coordinates to everyone except the owner.
city, countryBase city and 2-letter country code.
placement0 indoor, 1 outdoor.
status1 online, null offline.
mobile1 for mobile units.
versionsw, versionhwFirmware and hardware version.
detector, factorGeiger tube and its conversion factor from CPM to dose rate (µSv/h).
aqiEuropean Air Quality Index, 1 to 6: Good, Fair, Moderate, Poor, Very poor, Extremely poor (EEA bands revised in 2024), computed from PM2.5 and PM10.
note, picture, ownerOwner's note, picture URL, owner user ID.
param_XX, last_XX, avg_XXName and unit, latest value and moving average of sensor XX.

Sensor keys

Each unit reports the sensors of its model. GET /devices/{id} lists them.

GroupKeyMeaningUnit
Air qualitypm1, pm25, pm10PM1.0, PM2.5, PM10µg/m³
pm03no … pm10noParticle counts (0.3 to 10 µm)no/0.1L
co2Carbon dioxideppm
ch2oFormaldehydeppb
o3, no2Ozone, nitrogen dioxideppb
coCarbon monoxideppm
vocVolatile organic compounds (sensor resistance, index or µg/m³, depending on model)Ohm / Index / µg/m³
vocaqiVOC air quality indexAQI
gas1 … gas4Configurable electrochemical cells (name given in param_gasN)ppm (O2: % vol)
Radiationcpm, cpm2Geiger counter counts per minute. Dose rate in µSv/h = cpm × factorcpm
radonRadon concentrationBq/m³
Climate and weathertemperature, humidity, pressureAir temperature, relative humidity, barometric pressure (second sensor: suffix 2)°C, % RH, Pa
windspeed, windgustWind speed and gustm/s
windforceWind forceBeaufort
winddirectionWind direction°
rain, rainrateRain accumulation and intensitymm, mm/h
irradianceSolar irradianceW/m²
illuminanceIlluminancelux
uvUVmW/cm²
Noisenoise, noisemaxSound level and maximum (second microphone: noise2, noise2max)dB
Waterwtemperature, turbidity, do, orp, ec, phWater temperature, turbidity, dissolved oxygen, redox potential, conductivity, pH°C, NTU, µg/L, mV, ms/cm, pH
DevicesignalRadio signal strengthdBm
battery, voltage, dutyBattery voltage, Geiger tube voltage and duty cycleV, V, ‰
speed, altitude, satsMobile units: speed, altitude, GPS satelliteskm/h, m, no

Fair use: the uRADMonitor Shield

The Shield protects the network against abuse. It counts every call per IP address and refuses calls above the limits until the hour or the day resets. Limits for registered users:

Downloads / hourDownloads / dayUploads / hourUploads / day
1,0005,00010,000100,000

Calls without credentials have lower limits. If you need more for a research or public project, contact us.

API credits

Every upload from a unit you own adds one credit to your account. Credits accumulate and are shown in the API tab of the dashboard. They are not consumed by API calls at this time.

Embed live data

Every city and sensor page has a free embed code: a small live card plus a text link. It refreshes on its own and works on any website, including school and municipality sites.

License and citation

The data is published under Creative Commons Attribution 4.0 (CC BY 4.0). Use of the API is also governed by the General Terms and the API Terms. When you publish results, cite: uRADMonitor environmental monitoring network, Magnasci SRL, https://www.uradmonitor.com.

API and data updates

Monthly summary and network news. One email a month, unsubscribe anytime.

Readings are indicative and not a substitute for official regulatory monitoring.