📚 Overview

The Alarms.Global API provides real-time access to global transport disruptions, natural disasters, and public holidays data. Perfect for logistics companies, travel agencies, and supply chain management systems.

Base URL

https://api.alarms.global/v1

Key Features

  • Real-time transport disruption alerts
  • Global public holidays database (190+ countries)
  • Multi-language support (15 languages)
  • Impact level classification
  • Geolocation data for all incidents
  • Historical data access

🔐 Authentication

All API requests require authentication using an API key. Include your API key in the request header:

X-API-Key: YOUR_API_KEY_HERE

To obtain an API key, subscribe to one of our plans.

GET Top Incidents

Returns the most critical and impactful recent disruptions sorted by severity and recency.

GET /api/disruptions/top

Query Parameters

Parameter Type Required Description
lang string Optional Language code (en, es, fr, de, zh, ja, etc.). Default: en
limit integer Optional Number of incidents to return (1-50). Default: 10

Example Request

curl -X GET "https://api.alarms.global/v1/api/disruptions/top?lang=en&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "id": "0198f0cb-f62c-7033-b2c3-cb328de6bf22",
      "title": "Sialkot International Airport temporarily closed",
      "summary": "Airport closed due to heavy rains and flooding...",
      "category": "Transport",
      "impact": "International",
      "eventDate": "2025-08-28T13:00:00Z",
      "location": {
        "name": "Sialkot International Airport",
        "country": "Pakistan",
        "countryCode": "PK",
        "lat": 32.53556,
        "lon": 74.36389
      },
      "impactDetails": {
        "impactStatementShort": "Airport closed; flights moved to Lahore",
        "impactedServices": [
          "Sialkot–Jeddah flights",
          "Sialkot–Kuwait flights"
        ],
        "guidanceForBusiness": "Re-route operations..."
      },
      "sourceUrl": "https://example.com/news/123",
      "imageUrl": "https://example.com/image.jpg"
    }
  ],
  "count": 5,
  "timestamp": "2025-08-30T10:00:00Z"
}

GET All Disruptions

Returns transport disruptions and natural disasters based on filters.

GET /api/disruptions

Query Parameters

Parameter Type Required Description
category string Optional Filter by category: "transport" or "disaster"
hours integer Optional Get disruptions from last N hours (max 168). Default: 48
country string Optional ISO country code (e.g., US, GB, DE)
lang string Optional Language code for translations

GET Public Holidays

Returns upcoming public holidays worldwide or for specific countries.

GET /api/holidays

Query Parameters

Parameter Type Required Description
days integer Optional Days ahead to look (1-365). Default: 30
location string Optional Country name or ISO code
category string Optional Holiday type: National, Regional, or Cultural
lang string Optional Language code for translations

⚡ Rate Limits

Rate limits vary by plan:

  • Free: 100 requests/day
  • Starter: 1,000 requests/day
  • Professional: 10,000 requests/day
  • Enterprise: Unlimited

Rate limit headers are included in all responses:

  • X-RateLimit-Limit: Request limit
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Reset timestamp

💳 Pricing Plans

Free

$0/month
  • 100 API calls/day
  • Basic disruption data
  • 7-day history
  • Email support

Professional

$99/month
  • 10,000 API calls/day
  • All disruption data
  • 90-day history
  • Webhook support
  • Priority support
  • Custom alerts

Enterprise

Custom
  • Unlimited API calls
  • Full historical data
  • Custom integrations
  • SLA guarantee
  • Dedicated support
  • White-label options

🤝 Support

Need help integrating our API or have questions about our services?