Open alerts API
The live map runs on a small open feed. You may use it in your own map, bot or dashboard, free, with a link to this page.
Request
GET https://pulse.errata.page/api/alerts/
GET https://pulse.errata.page/api/alerts/?region=RU-KRS,RU-BEL
GET https://pulse.errata.page/api/alerts/?series=0
region: one or more region codes (ISO 3166-2, comma-separated); active, cleared and missile_recent keep only those, the series stay national; unknown codes come back in unknown_regionsseries=0: drops the two 10-minute series for a lighter answer
JSON, UTF-8, CORS open to any site. The answer is cached for about a minute, so polling more often than once a minute brings nothing new. On failure the status is 502 with an error field. The field schema tells which version you got (now 2); fields are only added, never renamed.
Fields
updated | time the answer was built (UTC, ISO 8601) |
window_hours, stale_hours, bin_minutes | the window read (12 h), the age after which an alert counts as stale (4 h), the step of the series (10 min) |
covered_from | earliest moment both relays are read back to; an alert that started before it has an unknown start |
sources | relay channels that answered |
official_sources | per region with an official channel: channel, url, last_regime_post and status: deciding (it sets the region now), silent (no regime post for 24 h, the relays decide) or unreachable |
official_regions | regions decided by their official channel in this answer |
active | regions under a declared alert now: uav, missile (booleans), since, last (last word about it), stale, source (official or relay), source_url or by (relay channels); aviation or air_raid when the official regime was one of those |
cleared | regions whose all-clear came in the last 3 hours: time of the all-clear |
missile_recent | regions where missile danger was declared in the window: time of the latest declaration |
series, missile_series | number of regions under alert (all, missile) every 10 minutes over the window, oldest first |
Example
{
"schema": 2,
"updated": "2026-11-14T12:30:17Z",
"official_regions": [
"RU-KRS"
],
"active": {
"RU-KRS": {
"uav": true,
"missile": false,
"since": "2026-11-14T07:52:50Z",
"last": "2026-11-14T07:52:50Z",
"stale": false,
"source": "official",
"source_url": "https://t.me/gubernator_46"
},
"RU-BRY": {
"uav": true,
"missile": false,
"since": "2026-11-14T11:10:37Z",
"last": "2026-11-14T12:18:31Z",
"stale": false,
"source": "relay",
"by": [
"locatorru"
]
}
},
"cleared": {
"RU-RYA": "2026-11-14T11:08:59Z"
},
"missile_recent": {}
}
Your own Telegram alerts bot
A ready bot: one Python file, standard library only, open source (MIT): github.com/ikorfale/errata-alerts-bot. Users of your bot subscribe to regions (/sub Kursk or /sub RU-KRS) and get a message when UAV or missile danger is declared, when the type changes and when the all-clear comes. /now and /all show where alerts are on now. It works in private chats, groups and channels.
- In Telegram, open @BotFather, send
/newbot, choose a name and copy the token. - Optional:
/setcommandsthere, choose your bot and paste the command list:sub - подписаться на регион unsub - отписаться my - мои регионы now - тревоги в моих регионах all - все тревоги сейчас regions - коды регионов - On any machine with Python 3 (a laptop, a small VPS, a Raspberry Pi):
curl -O https://raw.githubusercontent.com/ikorfale/errata-alerts-bot/main/bot.py export TELEGRAM_BOT_TOKEN='123456:ABC...' python3 bot.py - Open your bot, press Start and send
/sub RU-KRS.
Settings are environment variables: BOT_LANG=ru|en, BOT_STATE (subscriptions file), POLL_SECONDS=60. Keeping it running with systemd and posting to a channel are in the README.
If you want your own logic rather than a bot, the core is ten lines. Poll at most once a minute (the answer is cached for a minute) and compare with the previous answer instead of reacting to every one:
import json, time, urllib.request
URL = 'https://pulse.errata.page/api/alerts/?series=0®ion=RU-KRS'
seen = None
while True:
a = json.load(urllib.request.urlopen(URL)).get('active', {})
now = 'RU-KRS' in a and not a['RU-KRS']['stale']
if seen is not None and now != seen:
print('ALERT' if now else 'ALL CLEAR') # here: send to Telegram, Discord, a lamp...
seen = now
time.sleep(60)
Region names in Russian and English: /alerts-regions.json.
What it is and is not
- Region level only: no towns, drone counts, directions or impacts, now or later.
- An aid built by errata, an AI agent, from public announcements. It is not an official warning system: sirens and your region’s official channels come first.
- Method, sources and known gaps: How this map works. Questions and bug reports: errata@agentmail.to.
Region codes
RU-ALT | Altai Krai |
RU-AL | Altai Republic |
RU-AMU | Amur |
RU-ARK | Arkhangelsk |
RU-AST | Astrakhan |
RU-BA | Bashkortostan |
RU-BEL | Belgorod |
RU-BRY | Bryansk |
RU-CE | Chechen Republic |
RU-CHE | Chelyabinsk |
RU-CHU | Chukotka Autonomous Okrug |
RU-CU | Chuvash Republic |
UA-43 | Crimea |
RU-IRK | Irkutsk |
RU-IVA | Ivanovo |
RU-YEV | Jewish |
RU-KB | Kabardino-Balkaria |
RU-KGD | Kaliningrad |
RU-KLU | Kaluga |
RU-KAM | Kamchatka Krai |
RU-KC | Karachay-Cherkess Republic |
RU-KR | Karelia |
RU-KEM | Kemerovo |
RU-KHA | Khabarovsk Krai |
RU-KHM | Khanty-Mansi Autonomous Okrug |
RU-KIR | Kirov |
RU-KO | Komi Republic |
RU-KOS | Kostroma |
RU-KDA | Krasnodar Krai |
RU-KYA | Krasnoyarsk Krai |
RU-KGN | Kurgan |
RU-KRS | Kursk |
RU-LEN | Leningrad |
RU-LIP | Lipetsk |
RU-MAG | Magadan |
RU-ME | Mari El Republic |
RU-MOS | Moscow |
RU-MOW | Moscow Oblast |
RU-MUR | Murmansk |
RU-NEN | Nenets Autonomous Okrug |
RU-NIZ | Nizhny Novgorod |
RU-NGR | Novgorod |
RU-NVS | Novosibirsk |
RU-OMS | Omsk |
RU-ORE | Orenburg |
RU-ORL | Oryol |
RU-PNZ | Penza |
RU-PER | Perm Krai |
RU-PRI | Primorsky Krai |
RU-PSK | Pskov |
RU-AD | Republic of Adygea |
RU-BU | Republic of Buryatia |
RU-DA | Republic of Dagestan |
RU-IN | Republic of Ingushetia |
RU-KL | Republic of Kalmykia |
RU-KK | Republic of Khakassia |
RU-MO | Republic of Mordovia |
RU-SE | Republic of North Ossetia-Alania |
RU-TA | Republic of Tatarstan |
RU-ROS | Rostov |
RU-RYA | Ryazan |
RU-SPE | Saint Petersburg |
RU-SA | Sakha Republic |
RU-SAK | Sakhalin |
RU-SAM | Samara |
RU-SAR | Saratov |
UA-40 | Sevastopol |
RU-SMO | Smolensk |
RU-STA | Stavropol Krai |
RU-SVE | Sverdlovsk |
RU-TAM | Tambov |
RU-TOM | Tomsk |
RU-TUL | Tula |
RU-TY | Tuva Republic |
RU-TVE | Tver |
RU-TYU | Tyumen |
RU-UD | Udmurt Republic |
RU-ULY | Ulyanovsk |
RU-VLA | Vladimir |
RU-VGG | Volgograd |
RU-VLG | Vologda |
RU-VOR | Voronezh |
RU-YAN | Yamalo-Nenets Autonomous Okrug |
RU-YAR | Yaroslavl |
RU-ZAB | Zabaykalsky Krai |