Get 48-hour hourly and 8-day daily forecasts of environmental risks for a location.
Request
Your API key for authentication. Format: Bearer YOUR_API_KEY
Query Parameters
The latitude and longitude for the location to check, formatted as {latitude},{longitude}.
Response
A unique identifier for this response. Use this ID if submitting feedback about the forecast.
48 hourly entries, each containing the set of environmental risks for that hour. ISO 8601 timestamp (UTC) representing the forecast hour.
The environmental risks predicted for this hour. The unique identifier for the environmental risk.
The human-readable title of the risk.
The status of this risk assessment:
applicable: Risk is present and relevant for this location
not_applicable: Risk is not present or relevant for this location
unavailable: Risk data is unavailable for this location
error: An error occurred while assessing this risk
A number from 0-3 representing the risk level:
0: None
1: Low
2: Medium
3: High
A collection of 1-2 sentence strings with tips and recommendations.
A 1-2 sentence summary of the tips and key information.
Error message describing what went wrong. Only present when status is error.
32 daily entries over 8 days. 4 timestamps per day: morning (06:00), noon (12:00), evening (18:00), midnight (00:00), each containing the set of environmental risks. ISO 8601 timestamp (UTC) representing the forecast time.
The environmental risks predicted for this time. The unique identifier for the environmental risk.
The human-readable title of the risk.
The status of this risk assessment:
applicable: Risk is present and relevant for this location
not_applicable: Risk is not present or relevant for this location
unavailable: Risk data is unavailable for this location
error: An error occurred while assessing this risk
A number from 0-3 representing the risk level:
0: None
1: Low
2: Medium
3: High
A collection of 1-2 sentence strings with tips and recommendations.
A 1-2 sentence summary of the tips and key information.
Error message describing what went wrong. Only present when status is error.
Example
curl "http://api.goes.health/v1/risks/environmental/forecast?location=34.0522,-118.2437" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"responseId" : "123e4567-e89b-12d3-a456-426614174000" ,
"hourly" : [
{
"time" : "2024-06-27T00:00:00Z" ,
"risks" : [
{
"id" : "sunburn" ,
"title" : "Sunburn" ,
"status" : "applicable" ,
"score" : 2 ,
"summary" : "..." ,
"tips" : [
"..."
]
}
]
}
],
"daily" : [
{
"time" : "2024-06-27T06:00:00Z" ,
"risks" : [
{
"id" : "sunburn" ,
"title" : "Sunburn" ,
"status" : "applicable" ,
"score" : 2 ,
"summary" : "..." ,
"tips" : [
"..."
]
}
]
}
]
}
The latitude and longitude, formatted as {latitude},{longitude} .
A comma-separated list of environmental risk IDs to include in the forecast.
Comma-separated list of forecast types to exclude from the response. Options: hourly , daily
Comma-separated list of sections to exclude from the response. Options: tips , summary , score
A forecast of environmental risks with hourly and/or daily data.
A unique identifier for this response
48 hourly entries, each containing the set of environmental risks for that hour.
32 daily entries over 8 days. 4 timestamps per day: morning (06:00), noon (12:00), evening (18:00), midnight (00:00), each containing the set of environmental risks.