Skip to main content

​
Setup

Request an API key here

​
Basic Request

Let’s check for current environmental risks at Half Dome in Yosemite: 
curl "https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581" \
  -H "Authorization: Bearer YOUR_API_KEY"
All responses include an array of risks: 
{
  "responseId": "123e4567-e89b-12d3-a456-426614174000",
  "risks": [
    {
      "id": "sunburn",
      "title": "Sunburn",
      "tips": [
        ...
      ]
    }, 
    {
      "id": "heat-illness",
      "title": "Heat Illness",
      "tips": [
        ...
      ]
    }
  ]
}
If a risk is not present, it will be omitted from the risks.

​
Precise Request

Request specific risks by passing their IDs. Available risk IDs: sunburn, high-altitude, heat-illness, breathing-problems, frostbite, hypothermia, lightning. 
curl "https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581&ids=sunburn,high-altitude" \
  -H "Authorization: Bearer YOUR_API_KEY"
This behavior is also supported by the /wildlife and /plants endpoints.

​
Complete Request

Get a comprehensive overview including all environmental risks (sunburn, high-altitude, heat-illness, breathing-problems, frostbite, hypothermia, lightning), wildlife risks (bears, venomous-snakes, mosquitoes, ticks), plant risks (poison-sumac, poison-oak, poison-ivy), national alerts, and a personalized AI summary. 
curl -X POST "https://api.goes.health/v1/risks/overview" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "location": "37.7325,-119.5581",
    "profile": {
      "activity": "hiking"
    }
  }'

​
Next Steps

Need help or have questions? Email us at [email protected].