Weather Alert

Get officially issued real-time severe weather alert data around the world.

Hint: For the implementation of weather alert, see Resource - Alert Info in advance.

Endpoint#

GET /weatheralert/v1/current/{latitude}/{longitude}

Parameters#

Path parameters

  • latitude (required) The latitude of the desired location. Decimal format, up to 2 decimal places. For example 39.92
  • longitude (required) The longitude of the desired location. Decimal format, up to 2 decimal places. For example 116.41

Query parameters

  • localTime Whether to return local time for the requested location. true returns local time; false returns UTC time (default).
  • lang Multi-language setting, please see Language to find out how our multi-language works and how to set up.

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/weatheralert/v1/current/39.92/116.41?localTime=false&lang=en'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "metadata": {
    "tag": "0940b1221a969f15219673d1eaef532ec683bde88522f32155e6025d63fa1747",
    "zeroResult": false,
    "attributions": [
      "https://developer.qweather.com/attribution.html",
      "Alert data may be delayed or out of date. Refer to official sources for the latest data."
    ]
  },
  "alerts": [
    {
      "id": "202510162100007104337971",
      "senderName": "Meteorological Service of New Zealand Limited",
      "issuedTime": "2025-10-16T21:00Z",
      "messageType": {
        "code": "update",
        "supersedes": [
          "202510160638008946296098"
        ]
      },
      "latestChange": null,
      "eventType": {
        "name": "wind",
        "code": "2551"
      },
      "urgency": "future",
      "severity": "moderate",
      "certainty": "likely",
      "icon": "2551",
      "color": {
        "code": "orange",
        "red": 255,
        "green": 13,
        "blue": 24,
        "alpha": 1
      },
      "effectiveTime": "2025-10-17T10:00Z",
      "onsetTime": "2025-10-17T10:00Z",
      "expireTime": "2025-10-18T00:00Z",
      "headline": "Strong Wind Warning - Orange",
      "description": "Severe gale northwesterlies gusting 130km/h in exposed places. Impact: Damage to trees, powerlines, and unsecured structures possible. Driving may be difficult, especially for high-sided vehicles and motorcycles. Chance of upgrading to a Red Warning: Minimal. Changes: Watch upgraded to an Orange Warning.",
      "criteria": "Widespread severe gales with a minimum mean speed of 90km/h or frequent gusts exceeding 110km/h.",
      "responseTypes": [
        "monitor"
      ],
      "instruction": "Action: Prepare your property by securing items that can be picked up by strong winds. Drive cautiously."
    }
  ]
}
  • metadata object Metadata for this response
    • tag string Unique tag for this data
    • zeroResult boolean true indicates the request is successful but no data is available, e.g. no alert data for the queried location
    • attributions array Data attribution list that must be displayed with the current data
  • alerts array Weather alert list
    • id string The ID of this alert message
    • senderName string The name of the agency or authority issuing this alert, may be null
    • issuedTime date-time The time when the original alert message was generated. The actual release or receipt time may be slightly delayed
    • messageType object The nature of the alert message
      • code string Nature code
      • supersedes array Alert IDs that are superseded by this message, return null when it is a new alert.
    • eventType object The type of the alert event
      • name string Name of the alert event
      • code string Code of the alert event
    • urgency string The urgency of the alert message, may be null
    • severity string The severity of the alert message
    • certainty string The certainty of the alert message, may be null
    • icon string Icon code for this alert
    • color object RGBA color for this alert.
      • code string Color code for this alert
      • red number Red component in RGBA, [0, 255]
      • green number Green component in RGBA, [0, 255]
      • blue number Blue component in RGBA, [0, 255]
      • alpha number Alpha (opacity) in RGBA, [0, 1]
    • effectiveTime date-time The effective time of the alert message, may be null
    • onsetTime date-time The expected time of the beginning of this alert event, may be null
    • expireTime date-time The expiry time of the alert message
    • headline string Headline or brief of the alert message
    • description string Description of the alert message
    • criteria string The criteria or condition for triggering this alert. This is for reference only and may out of date with official standard. May be null
    • responseTypes array Type code of recommended action for this alert, may be null
    • instruction string The recommended action for this alert, may be null