Weather Warnings

Governmental severe weather warnings are currently delivered from: Argentina, Australia, Austria, Belarus, Belgium, Bosnia and Herzegovina, Brazil, Bulgaria, Canada, Chile, Colombia, Costa Rica, Croatia, Cyprus, Czech Republic, Denmark, Ecuador, Egypt, Estonia, Finland, France, Germany, Greece, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Republic of Ireland, Israel, Italy, Japan, South Korea, Latvia, Lithuania, Luxembourg, North Macedonia, Malaysia, Malta, Mexico, Moldova, Montenegro, Netherlands, New Zealand, Norway, Peru, Philippines, Poland, Portugal, Romania, Russia, Saudi Arabia, Serbia, Singapore, Slovakia, Slovenia, Spain, Sweden, Switzerland, South Africa, Taiwan, Thailand, Ukraine, United Kingdom and United States.

Get an API key OpenAPI spec for AI assistantsJSON · 105 KB

Full API reference — quickstart, authentication, request limits and attribution.

Governmental severe weather warnings are currently delivered from: Argentina, Australia, Austria, Belarus, Belgium, Bosnia and Herzegovina, Brazil, Bulgaria, Canada, Chile, Colombia, Costa Rica, Croatia, Cyprus, Czech Republic, Denmark, Ecuador, Egypt, Estonia, Finland, France, Germany, Greece, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Republic of Ireland, Israel, Italy, Japan, South Korea, Latvia, Lithuania, Luxembourg, North Macedonia, Malaysia, Malta, Mexico, Moldova, Montenegro, Netherlands, New Zealand, Norway, Peru, Philippines, Poland, Portugal, Romania, Russia, Saudi Arabia, Serbia, Singapore, Slovakia, Slovenia, Spain, Sweden, Switzerland, South Africa, Taiwan, Thailand, Ukraine, United Kingdom and United States.

Weather Warnings Operations
GET/api/v1/warning/{location}GET/api/v1/warning/types

Endpoints

Point warnings

Path Parameters

locationType: stringrequired

"Longitude, latitude" or location identifier (id) from the location endpoint

Query Parameters

futureType: string

Whether to return warnings starting more than 24 hours from now (boolean: default 0)

datasetType: string

Variable set: "standard" or "full" (default "standard")

GET/api/v1/warning/{location}Shell Curl
curl 'https://weatherapi.foreca.net/api/v1/warning/{location}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
200
{
  "warnings": [
    {
      "type": "FO",
      "significance": "Y",
      "attribution": null,
      "validFrom": "2021-01-08T10:17:00Z",
      "validUntil": "2021-01-08T17:00:00Z",
      "description": [
        {
          "lang": "en",
          "text": "Dense Fog Advisory issued January 08 at 4:17AM CST until January 08 at 11:00AM CST by NWS Minneapolis&10;&10;Anoka; Benton; Blue Earth; Brown; Carver; Chippewa; Chisago; Douglas; Hennepin; Isanti; Kanabec; Kandiyohi; Lac Qui Parle; Le Sueur; Martin; McLeod; Meeker; Mille Lacs; Morrison; Nicollet; Pope; Ramsey; Redwood; Renville; Scott; Sherburne; Sibley; Stearns; Stevens; Swift; Todd; Watonwan; Wright; Yellow Medicine&10;&10;...DENSE FOG ADVISORY REMAINS IN EFFECT UNTIL 11 AM CST THIS&10;MORNING...&10;* WHAT...Visibility one quarter mile or less in dense fog.&10;* WHERE...Portions of central, east central, south central,&10;southwest and west central Minnesota.&10;* WHEN...Until 11 AM CST Friday.&10;* IMPACTS...Hazardous driving conditions due to low visibility.&10;* ADDITIONAL DETAILS...Slick spots on roads, overpasses, and&10;sidewalks are also possible as the fog freezes on exposed&10;surfaces.&10;&10;If driving, slow down, use your headlights, and leave plenty of&10;distance ahead of you."
        }
      ],
      "attributionUrl": null,
      "link": "https://alerts.weather.gov/cap/wwacapget.php?x=MN126188507444.DenseFogAdvisory.126188517F10MN.MPXNPWMPX.6f0fa4bac3937d8409b5648ff85e9eea",
      "sent": "2021-01-08T10:17:00Z",
      "name": "Fog",
      "significanceDescription": "Potentially dangerous"
    }
  ]
}
{
  "type": "object",
  "properties": {
    "warnings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "example": "FO",
            "description": "Warning ID"
          },
          "significance": {
            "type": "string",
            "example": "Y",
            "description": "One of: Y (yellow, moderate), O (orange, severe), R (red, extreme), P (purple, emergency), NP (not applicable, very minor)"
          },
          "attribution": {
            "type": "string",
            "nullable": true,
            "description": "Attribution: organization abbreviations"
          },
          "validFrom": {
            "type": "string",
            "example": "2021-01-08T10:17:00Z",
            "description": "ISO 8601 date and time"
          },
          "validUntil": {
            "type": "string",
            "example": "2021-01-08T17:00:00Z",
            "description": "ISO 8601 date and time"
          },
          "description": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "lang": {
                  "type": "string",
                  "example": "en",
                  "description": "Language of warning description (ISO 639-1 codes)"
                },
                "text": {
                  "type": "string",
                  "example": "Dense Fog Advisory issued January 08 at 4:17AM CST until January 08 at 11:00AM CST by NWS Minneapolis&10;&10;Anoka; Benton; Blue Earth; Brown; Carver; Chippewa; Chisago; Douglas; Hennepin; Isanti; Kanabec; Kandiyohi; Lac Qui Parle; Le Sueur; Martin; McLeod; Meeker; Mille Lacs; Morrison; Nicollet; Pope; Ramsey; Redwood; Renville; Scott; Sherburne; Sibley; Stearns; Stevens; Swift; Todd; Watonwan; Wright; Yellow Medicine&10;&10;...DENSE FOG ADVISORY REMAINS IN EFFECT UNTIL 11 AM CST THIS&10;MORNING...&10;* WHAT...Visibility one quarter mile or less in dense fog.&10;* WHERE...Portions of central, east central, south central,&10;southwest and west central Minnesota.&10;* WHEN...Until 11 AM CST Friday.&10;* IMPACTS...Hazardous driving conditions due to low visibility.&10;* ADDITIONAL DETAILS...Slick spots on roads, overpasses, and&10;sidewalks are also possible as the fog freezes on exposed&10;surfaces.&10;&10;If driving, slow down, use your headlights, and leave plenty of&10;distance ahead of you.",
                  "description": "Description of the particular warning in the associated language"
                }
              }
            }
          },
          "attributionUrl": {
            "type": "string",
            "nullable": true,
            "description": "Attribution URL"
          },
          "link": {
            "type": "string",
            "example": "https://alerts.weather.gov/cap/wwacapget.php?x=MN126188507444.DenseFogAdvisory.126188517F10MN.MPXNPWMPX.6f0fa4bac3937d8409b5648ff85e9eea",
            "description": "Link to warning description provided by source (if applicable)"
          },
          "sent": {
            "type": "string",
            "example": "2021-01-08T10:17:00Z",
            "description": "ISO 8601 date and time of warning sent"
          },
          "name": {
            "type": "string",
            "example": "Fog"
          },
          "significanceDescription": {
            "type": "string",
            "example": "Potentially dangerous",
            "description": "Description of significance level"
          }
        }
      }
    }
  }
}
Success

Warning type names

The full code-to-name mapping for every warning type, so you can label warnings in your own interface. Returns each two-letter type code with its display name. The same codes name the downloadable warning icons, combined with a severity suffix.

GET/api/v1/warning/typesShell Curl
curl 'https://weatherapi.foreca.net/api/v1/warning/types' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
200
{
  "AQ": {
    "name": "Air quality"
  },
  "AS": {
    "name": "Volcanic ashfall"
  },
  "AV": {
    "name": "Avalanche"
  },
  "CD": {
    "name": "Civil danger"
  },
  "CE": {
    "name": "Coastal event"
  }
}
{
  "type": "object",
  "properties": {
    "AQ": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Air quality",
          "description": "Name of warning type"
        }
      }
    },
    "AS": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Volcanic ashfall",
          "description": "Name of warning type"
        }
      }
    },
    "AV": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Avalanche",
          "description": "Name of warning type"
        }
      }
    },
    "CD": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Civil danger",
          "description": "Name of warning type"
        }
      }
    },
    "CE": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Coastal event",
          "description": "Name of warning type"
        }
      }
    }
  }
}
Success