Sunburn

Heat Illness

Hypothermia

Frostbite

Lightning

High Altitude Illness

Breathing Problems

Poison Ivy

Poison Oak

Poison Sumac

Bears

Venomous Snakes

Mosquitoes

Ticks

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: Use when only environment risks (e.g. Heat Illness, Breathing Problems) and tips are needed.


      GET /environmental

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


      GET /wildlife

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


      GET /plants

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


      GET /overview

View endpoint → Use for 48-hour and 8-day environmental risk forecasts to plan ahead.


      GET /environmental/forecast

View endpoint → Use for comprehensive extended forecasts with all risks, alerts, and AI-generated insights.


      GET /overview/forecast

View endpoint → ## Authentication All API requests require an API key in the Authorization header: ```bash theme={null} curl "https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581" \ -H "Authorization: Bearer YOUR_API_KEY" ``` [Request an API key here](mailto:api@goes.health?subject=API%20Key%20Request) ## Rate Limits * 600 requests per minute by default * Contact us for higher volume needs Ready to start? Check out our [Quickstart Guide](/documentation/quickstart) or dive into the [API Reference](/api-reference/risks). # Overview Source: https://docs.goes.health/documentation/overview Learn about GOES and how to get started ## Building with GOES Core API GOES Core API is a location-aware service that forecasts environmental risks and delivers corresponding safety tips and guidance—from UV and poisonous plant exposure to wildlife activity and natural disasters. It empowers developers, product teams, and risk managers to embed forward-looking outdoor health intelligence directly into any platform, service, or experience. Built by 25+ wilderness medicine physicians and validated by thousands of users, GOES Core API equips your system to deliver personalized outdoor risk insight and action-ready guidance—when and where it matters most. ## GOES Core API Offers: ### Real-time, 48-hour, and 8-day risk forecasts * Environmental risks (e.g., sunburn) * Wildlife risks (e.g., bears, venomous snakes) * Terrain risks (e.g., high altitude) * Poisonous plant risks (e.g., poison ivy) * NOAA Severe Weather Alerts * And more ### Severity-based Outdoor Health & Safety Tips & Guidance * Tied to each identified risk type: environmental, wildlife, terrain, poisonous plant, and severe weather ### GOES AI (Activity Intelligence) * Personalized safety summaries based on risk and user context, including activity type, experience level, and terrain ## Example Use Cases and Value for GOES Core API ### Fitness & Activity Apps By integrating risk forecasting and actionable guidance, Fitness and Activity applications can introduce premium health & safety capabilities and corresponding pricing tiers, create new user experience opportunities, access expanded user behavior and data insights, and benefit from increased brand trust. * Show heat index warnings before runs or hikes * Deliver micro-prep insights: hydration reminders, altitude impact based on pace and elevation * Enable contextual alerts (e.g., "You're 1,500 ft higher than yesterday—slow down to prevent AMS") * Use forecasted UV/sunburn risk to trigger hydration/sunscreen reminders * Tailor activity prep guidance by user experience (e.g., "first-time hiker") * Push alerts for NOAA severe weather within training windows ### Outdoor Mapping Applications & Services By integrating risk forecasting and wilderness medical overlays, Outdoor Mapping platforms can drive increased user engagement, enable differentiated premium offerings, surface new geo-contextual insights, and elevate their brand as an indispensable outdoor planning tool. * Overlay terrain-specific health guidance directly onto route maps * Visualize real-time or forecasted environmental risk levels along trails * Offer adaptive routing that minimizes safety threats * Cache risk-based tips and guidance for offline use * Update trail safety ratings based on forecasted environmental hazards ### Travel & Adventure Planning Platforms By embedding health intelligence and dynamic risk forecasting, Travel and Adventure Planning platforms can reduce customer cancellations and liability, unlock premium trip tiers, improve traveler satisfaction, and differentiate on trust and preparedness. * Integrate live and forecasted risk scoring into booking flows * Provide smart, location-aware pre-trip preparation checklists * Alert travelers of shifting conditions in real time during activities * Package activity-specific health tips into itineraries and confirmations * Offer bundled safety recommendations based on traveler profile and location ### Outdoor Employee Safety Platforms By delivering predictive risk monitoring and tailored health guidance, Outdoor Workforce Safety platforms can lower incident rates, reduce liability, improve regulatory compliance, and demonstrate leadership in employee wellness. * Forecast environmental risks for scheduled field deployments * Send real-time, location-specific risk alerts to field teams * Automate break schedules based on heat exposure thresholds * Provide role-based health guidance for field events and operations * Equip supervisors with dashboards for team safety oversight ### Insurance & Risk Management By incorporating location-specific health risk forecasting and real-time monitoring, Insurance and Risk platforms can improve underwriting accuracy, reduce preventable claims, offer differentiated digital engagement, and shift toward proactive prevention. * Use granular risk scores to inform underwriting decisions * Provide dynamic monitoring tools to policyholders for outdoor activity safety * Enable automated alerts that prompt preventative behavior * Supply historical environmental data for claims context * Offer bundled safety apps as part of premium coverage packages ### Mobile Safety & Emergency Apps By embedding location-aware, offline-capable medical intelligence, Mobile Safety and Emergency Apps can dramatically enhance user confidence, increase retention, reduce liability concerns, and stand apart from generic first-aid competitors. * Send real-time, geo-specific health and safety alerts * Cache risk-based tips and guidance for offline use * Use AI to generate personalized, situation-specific safety insights * Provide interactive medical response flows without connectivity * Empower users with proactive safety briefings before remote travel ## Getting Started 1. [Request an API key](mailto:api@goes.health?subject=API%20Key%20Request) 2. Follow our [Quickstart Guide](/documentation/quickstart) 3. Explore the [API Reference](/api-reference/risks) # Quickstart Source: https://docs.goes.health/documentation/quickstart Make your first GOES Health API request in minutes ## Setup Request an API key [here](mailto:api@goes.health?subject=API%20Key%20Request) ## Basic Request Let's check for current environmental risks at Half Dome in Yosemite: ```bash cURL theme={null} curl "https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ```jsx React theme={null} import { useEffect, useState } from 'react'; function RiskCheck() { const [risks, setRisks] = useState([]); useEffect(() => { fetch(`https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581`, { headers: { 'Authorization': `Bearer ${process.env.REACT_APP_GOES_API_KEY}` } }) .then(res => res.json()) .then(data => setRisks(data.risks)); }, []); return (

{risks.map(risk => (

{risk.title}

Severity: {risk.severity}

))}

); } ``` ```jsx React Native theme={null} import React, { useEffect, useState } from 'react'; import { View, Text, FlatList } from 'react-native'; function RiskCheck() { const [risks, setRisks] = useState([]); useEffect(() => { fetch(`https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581`, { headers: { 'Authorization': `Bearer ${process.env.GOES_API_KEY}` } }) .then(res => res.json()) .then(data => setRisks(data.risks)); }, []); return ( item.id} renderItem={({ item }) => ( {item.title} Severity: {item.severity} )} /> ); } ``` ```js Node.js theme={null} const GOES_API_KEY = process.env.GOES_API_KEY; async function checkRisks() { const response = await fetch( `https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581`, { headers: { 'Authorization': `Bearer ${GOES_API_KEY}` } } ); if (!response.ok) { throw new Error(`API error: ${response.status}`); } const data = await response.json(); console.log(data.risks); } ``` ```python Python theme={null} import os import requests from typing import Dict, List def check_risks() -> Dict: response = requests.get( "https://api.goes.health/v1/risks/environmental", params={ "location": "37.7325,-119.5581", }, headers={ "Authorization": f"Bearer {os.environ['GOES_API_KEY']}" }, timeout=10, ) response.raise_for_status() return response.json() ``` All responses include an array of `risks`: ```json theme={null} { "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`. ```bash cURL theme={null} curl "https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581&ids=sunburn,high-altitude" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ```jsx React theme={null} function RiskCheck() { const [risks, setRisks] = useState([]); useEffect(() => { fetch(`https://api.goes.health/v1/risks/environmental?location=37.7325,-119.5581&ids=sunburn,high-altitude`, { headers: { 'Authorization': `Bearer ${process.env.REACT_APP_GOES_API_KEY}` } }) .then(res => res.json()) .then(data => setRisks(data.risks)); }, []); return

{risks.map(risk =>

{risk.title}

)}

; } ``` ```python Python theme={null} def check_specific_risks(): response = requests.get( "https://api.goes.health/v1/risks/environmental", params={ "location": "37.7325,-119.5581", "ids": "sunburn,high-altitude", }, headers={ "Authorization": f"Bearer {os.environ['GOES_API_KEY']}" }, ) return response.json() ``` This behavior is also supported by the [/wildlife](/api-reference/wildlife) and [/plants](/api-reference/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. ```bash cURL theme={null} 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" } }' ``` ```jsx React theme={null} function CompleteOverview() { const [data, setData] = useState({}); useEffect(() => { fetch(`https://api.goes.health/v1/risks/overview`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${process.env.REACT_APP_GOES_API_KEY}` }, body: JSON.stringify({ location: "37.7325,-119.5581", profile: { activity: "hiking" } }) }) .then(res => res.json()) .then(setData); }, []); return (

{data.summary}

{data.risks?.map(risk =>

{risk.title}

)}

); } ``` ```python Python theme={null} def get_complete_overview(): response = requests.post( "https://api.goes.health/v1/risks/overview", json={ "location": "37.7325,-119.5581", "profile": { "activity": "hiking" } }, headers={ "Authorization": f"Bearer {os.environ['GOES_API_KEY']}" }, ) return response.json() ``` ## Next Steps * Explore the full **[API Reference](/api-reference/risks)** for optional parameters Need help or have questions? Email us at [api@goes.health](mailto:api@goes.health). # Home Source: https://docs.goes.health/index Real-time outdoor health and wildlife risk data

GOES Core API

Transform your products with outdoor health & safety intelligence—including environmental risk forecasts and corresponding wilderness medical content.

Get Started

Explore the docs

Overview

Learn about the GOES Health API

Quickstart

Start using the API in minutes

API Reference

Integrate the API into your application