API Reference

Weather Warnings

Extreme weather warnings from BMKG RSS/CAP. Data is refreshed hourly and refreshed on demand when the cache is empty.

Main endpoint
GET https://use.apiindonesia.id/api/v1/peringatan-dini
Endpoints
1
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

Extreme weather warnings from BMKG RSS/CAP. Data is refreshed hourly and refreshed on demand when the cache is empty.

Coverage
1

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/peringatan-dini

Returns all currently active weather warnings. Can be filtered by province name.

When should you use it?

The Weather Warnings API fits apps that need to inform users about potential severe weather from BMKG, such as operations dashboards, news apps, logistics tools, or internal company systems.

You need banners or notifications when active weather warnings exist.

Operations teams need affected-area data without manually reading RSS/CAP feeds.

The app needs periodic refreshes with caching when upstream data is empty or slow.

Warning content follows BMKG. For workplace-safety workflows, add internal escalation procedures and human validation.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Disaster-mitigation apps: forward severe-weather warnings to users in near-realtime.
  • Logistics & aviation ops: adjust operational schedules when severe weather warnings are active.
  • Media: auto-display weather-warning banners without manual editorial work.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/peringatan-dini?provinsi=Jawa+Barat" \\
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "data": [
    {
      "id": "warn_2-49-0-1-360-0-2026-07-05-21-18-003",
      "alert_id": "2.49.0.1.360.0.2026.07.05.21.18.003",
      "event": "Hujan Lebat disertai Petir",
      "urgency": "Expected",
      "severity": "Moderate",
      "certainty": "Likely",
      "area": "Batanghari, Bumi Waras, Enggal",
      "province": "Lampung",
      "effective": "2026-07-05T21:00:00.000Z",
      "expires": "06 July 2026, 07:30 WIB",
      "headline": "Hujan Lebat disertai Petir di Lampung",
      "description": "Hujan lebat disertai petir akan terjadi...",
      "instruction": "Ikuti informasi resmi BMKG dan arahan petugas setempat.",
      "source": "BMKG-CAP",
      "is_active": 1
    }
  ]
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Weather Warnings API questions

Where do the weather warnings come from?

From BMKG extreme-weather warnings published as RSS/CAP. Data refreshes hourly and is re-fetched when the cache is empty.

Can I filter by province?

Yes, with the provinsi parameter on GET /api/v1/peringatan-dini.

What is it typically used for?

Extreme-weather notifications in apps, Telegram bots or field-operations dashboards, often combined with the Earthquake API for disaster alerts.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization