Weather Alert

Get active official weather alerts worldwide for the specified latitude and longitude.

Endpoint#

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

Parameters#

Path parameters

latitude^required

number

Latitude of the requested location in decimal degrees
longitude^required

number

Longitude of the requested location in decimal degrees

Query parameters

localTime

boolean

Whether to return local time for the requested location

Possible values: false UTC time (default), true location's local time
lang

string

Language setting. See Language for behavior, configuration, and data availability

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/weatheralert/v1/current/39.92/116.41'

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 data identifier
- attributions
  
  array
  
  Data attribution or statements that must be displayed with the response data
- zeroResult
  
  boolean
  
  true indicates the request is successful but no data is available, e.g. no alert data for the queried location
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
  
  Alert message type
  - code
    
    string
    Message type code. Available values:
    
    alert The initial, active alert message
    
    update Updates and supersedes the alert messages identified in messageType.supersedes
    
    cancel Cancels the alert messages identified in messageType.supersedes. A message with the cancel type remains valid for 1 hour
  - supersedes
    
    array
    
    Previous alert messages superseded by this message
- eventType
  
  object
  
  Alert event type
  - name
    
    string
    
    Name of the alert event
  - code
    
    string
    
    Code of the alert event
- urgency
  
  string
  Urgency of the alert message. Available values:
  - immediate Immediate action is required
  - expected Action should be taken soon, usually within 1 hour
  - future Action should be taken in the near future
  - past The event is no longer occurring
  - unknown The urgency is unknown
- severity
  
  string
  Severity of the alert message. Available values:
  - unknown The severity is unknown
  - minor Minimal or no known threat to life or property
  - moderate Possible threat to life or property
  - severe Significant threat to life or property
  - extreme Extreme threat to life or property
- certainty
  
  string
  Certainty of the alert message. Available values:
  - observed The event has occurred or is occurring
  - likely The probability of occurrence is at least 50%
  - possible The event may occur, with a probability of no more than 50%
  - unlikely The event is not expected, with a probability close to 0
  - unknown The certainty is unknown
- icon
  
  string
  
  Icon code for this alert
- color
  
  object
  
  RGBA color for this alert.
  - code
    
    string
    
    Color code. Available values: white, gray, green, blue, yellow, amber, orange, red, purple, and black
  - red
    
    number
    
    Red component, range [0, 255]
  - green
    
    number
    
    Green component, range [0, 255]
  - blue
    
    number
    
    Blue component, range [0, 255]
  - alpha
    
    number
    
    Alpha component, range [0, 1]
- effectiveTime
  
  date-time
  
  The effective time of the alert message
- onsetTime
  
  date-time
  
  The expected time of the beginning of this alert event, maybe 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 conditions that triggered this alert. For reference only and may lag behind official standards, 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