​
Overview

The GOES API uses REST endpoints with JSON responses. Each endpoint is:
  • Location-aware: latitude/longitude in every request
  • Real-time: continuously updated location risks for time-sensitive decisions
  • Developer-friendly: predictable query parameters and standard HTTP status codes
  • Mobile-ready: lightweight responses designed for low-latency cell networks
Whether you are displaying a compact widget or powering a full-featured trip-planning assistant, the API lets you select exactly the data you need and nothing more.

​
Location Based Health Risks

Our API monitors a comprehensive set of outdoor health risks across multiple categories:

Weather & Climate

Sunburn
Heat Illness
Hypothermia
Frostbite
Lightning

Terrain & Air Quality

High Altitude Illness
Breathing Problems

Flora Hazards

Poison Ivy
Poison Oak
Poison Sumac

Wildlife & Insects

Bears
Venomous Snakes
Mosquitoes
Ticks

National Alerts

Severe Thunderstorm Warning
Red Flag Warning
Winter Storm Warning
Flash Flood Warning
Air Quality Alert
Tornado Warning
+104 more alert types…

​
API Endpoints

Our API provides six core endpoints to access outdoor risk intelligence:

Environmental Risks

Use when only environment risks (e.g. Heat Illness, Breathing Problems) and tips are needed.GET /environmentalView endpoint →

Wildlife Risks

Use when only wildlife risks (e.g. Bears, Venomous Snakes) and tips are needed.GET /wildlifeView endpoint →

Plant Risks

Use when only plant risks (e.g. Poison Ivy, Poison Oak) and tips are needed.GET /plantsView endpoint →

Overview & Summary

Use for a complete understanding of risks and recommendations. Includes all previous endpoint data and more.GET /overviewView endpoint →

Environmental Forecast

Use for 48-hour, hour-by-hour environmental risk forecasts to plan ahead.GET /environmental/forecastView endpoint →

Overview Forecast

Use for comprehensive 48-hour forecasts with all risks, alerts, and AI-generated insights.GET /overview/forecastView endpoint →

​
Authentication

All API requests require an API key in the Authorization header: 
curl "https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581" \
  -H "Authorization: Bearer YOUR_API_KEY"
Request an API key here

​
Rate Limits

  • 600 requests per minute by default
  • Contact us for higher volume needs
Ready to start? Check out our Quickstart Guide or dive into the API Reference.