Edit

Weather Alert

Platform: API

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 

/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

  • localTimeWhether to return the local time of the queried location. true for local time, false for UTC time (default).
  • langMulti-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.90/116.40'

Replace your_token and your_api_host with your JWT Authentication and API Host

Response

The response is in JSON format and is Gzip compressed.

{
    "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.tag Unique tag for this data
  • metadata.zeroResult true indicates the request is successful but no data is available, e.g. no alert data for the queried location.
  • metadata.attributions Attributions for data sources or declarations, developers must display this information with data
  • alerts.id The ID of this alert message
  • alerts.senderName The name of the agency or authority issuing this alert, may be null
  • alerts.issuedTime The time when the original alert message was generated. The actual release or receipt time may be slightly delayed.
  • alerts.messageType.code The code of the alert message nature
  • alerts.messageType.supersedes Alert IDs that are superseded by this message, only relevant when messageType.code is update or cancel.
  • alerts.eventType.name Name of the alert event type
  • alerts.eventType.code Code of the alert event type
  • alerts.urgency The urgency of the alert message, may be null
  • alerts.severity The severity of the alert message
  • alerts.certainty The certainty of the alert message, may be null
  • alerts.icon Icon code for this alert
  • alerts.color.code Color code for this alert
  • alerts.color.red Red component in RGBA for this alert, range 0–255
  • alerts.color.green Green component in RGBA for this alert, range 0–255
  • alerts.color.blue Blue component in RGBA for this alert, range 0–255
  • alerts.color.alpha Alpha (opacity) in RGBA for this alert, range 0-1
  • alerts.effectiveTime The effective time of the alert message, may be null
  • alerts.onsetTime The expected time of the beginning of this alert event, may be null
  • alerts.expiredTime The expiry time of the alert message
  • alerts.headline Headline or brief of the alert message
  • alerts.description Description of the alert message
  • alerts.criteria The criteria or condition for triggering this alert. This is for reference only and may out of date with official standard. May be null
  • alerts.instruction The recommended action for this alert, may be null
  • alerts.responseTypes Type code of recommended action for this alert, may be null