Get Overview

cURL

curl --request GET \
  --url https://api.goes.health/v1/risks/overview

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.goes.health/v1/risks/overview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.goes.health/v1/risks/overview"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.goes.health/v1/risks/overview")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "responseId": "123e4567-e89b-12d3-a456-426614174000",
  "activity_intelligence": "For your Half Dome hike today, be prepared for significant elevation gain and exposed terrain. The combination of high altitude, bear activity, and lightning risk requires careful planning. Start early and monitor weather conditions closely.",
  "risks": [
    {
      "id": "sunburn",
      "title": "Sunburn",
      "source": "environment",
      "status": "applicable",
      "score": 2,
      "summary": "<string>",
      "tips": [
        "<string>"
      ]
    }
  ],
  "alerts": []
}

{
  "error": 123,
  "message": "<string>"
}

GET

risks

overview

cURL

curl --request GET \
  --url https://api.goes.health/v1/risks/overview

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.goes.health/v1/risks/overview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.goes.health/v1/risks/overview"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.goes.health/v1/risks/overview")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "responseId": "123e4567-e89b-12d3-a456-426614174000",
  "activity_intelligence": "For your Half Dome hike today, be prepared for significant elevation gain and exposed terrain. The combination of high altitude, bear activity, and lightning risk requires careful planning. Start early and monitor weather conditions closely.",
  "risks": [
    {
      "id": "sunburn",
      "title": "Sunburn",
      "source": "environment",
      "status": "applicable",
      "score": 2,
      "summary": "<string>",
      "tips": [
        "<string>"
      ]
    }
  ],
  "alerts": []
}

{
  "error": 123,
  "message": "<string>"
}

Coming Soon — This endpoint is under development and will be available at a future date.

Get a comprehensive overview of all risks and alerts for a location, combining environmental risks, wildlife risks, plant risks, and national weather alerts. Available in two formats: a simple cacheable GET request, or an advanced POST request with full personalization options.

Simple Request (GET)

Headers

string

required

Your API key for authentication. Format: Bearer YOUR_API_KEY

Query Parameters

string

required

The latitude and longitude for the location to check, formatted as {latitude},{longitude}.

object

Configuration options that control how the response is built.

Show options properties

string

Controls the length of the Activity Intelligence text. Available options:

brief: 1-2 sentences focusing on the most critical risks
standard: 3-4 sentences with key risks and basic context (default)
detailed: 5-7 sentences with comprehensive risk analysis and detailed recommendations

string

Comma-separated list of sections to exclude from the response. Options: alerts, environment, wildlife, plants, activity_intelligence

Example

# Basic request
curl "http://api.goes.health/v1/risks/overview?location=37.7485,-119.5331" \
  -H "Authorization: Bearer YOUR_API_KEY"

# With options
curl "http://api.goes.health/v1/risks/overview?location=37.7485,-119.5331&options.length=detailed&options.exclude=alerts" \
  -H "Authorization: Bearer YOUR_API_KEY"

Advanced Request (POST)

Headers

string

required

Your API key for authentication. Format: Bearer YOUR_API_KEY

Body Parameters

string

required

The latitude and longitude for the location to check, formatted as {latitude},{longitude}.

object

Configuration options that control how the response is built.

Show options properties

string

Controls the length of the Activity Intelligence text. Available options:

brief: 1-2 sentences focusing on the most critical risks
standard: 3-4 sentences with key risks and basic context (default)
detailed: 5-7 sentences with comprehensive risk analysis and detailed recommendations

array

A list of sections to exclude from the response. Available options:

alerts: Excludes national watches, warnings, and advisories
environment: Excludes environmental risks
wildlife: Excludes wildlife risks
plants: Excludes plant risks
activity_intelligence: Excludes the AI-generated Activity Intelligence

object

Information about who is going outside. This object is extensible - you can add custom fields beyond the standard ones listed below.

Show profile properties

string

The outdoor activity you plan to do (e.g., “hiking”, “camping”, “skiing”). This helps personalize the Activity Intelligence.

integer

The age of the person doing the activity. Used to provide age-appropriate risk analysis when summarizing.

integer

Experience level with outdoor activities, from 0 (beginner) to 4 (expert).

string

Any additional context that may be relevant for risk summarization. This helps provide more personalized recommendations.

Response

string

A unique identifier for this response. Use this ID if submitting feedback about the response.

string

An AI-generated summary paragraph that consolidates all risks and alerts, personalized to your activity and experience level.

array

A comprehensive array of all risks from environmental, wildlife, and plant sources.

Show child attributes

string

The unique identifier for the risk.

string

The human-readable title of the risk.

string

The source of this risk (“environment”, “wildlife”, or “plants”).

enum

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

integer

A number from 0-3 representing the risk level or prevalence:

For environmental risks: risk level from 0 (None) to 3 (High)
For wildlife and plant risks: prevalence score from 0 (None) to 3 (High)

array

A collection of 1-2 sentence strings with tips and recommendations.

string

A 1-2 sentence summary of the tips and key information.

string

Error message describing what went wrong. Only present when status is error.

array

An array of active NOAA weather alerts for the United States.

Show child attributes

string

The type of weather event. Example: Severe Thunderstorm Warning.

string

The severity level of the alert as specified by NOAA. Example: Severe.

string

The NWS office that issued the alert. Example: NWS Riverton WY.

string

A complete headline of the alert including timing and issuing office.

string

Detailed description of the weather event, including specific hazards, source of information, and impacts.

string

Safety instructions and recommended actions for the public.

Example

curl -X POST "http://api.goes.health/v1/risks/overview" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "location": "37.7485,-119.5331",
    "options": {
      "length": "standard",
      "exclude": []
    },
    "profile": {
      "activity": "hiking",
      "age": 32,
      "outdoor_experience": 2,
      "context": "First time hiker"
    }
  }'

Response

Both the GET and POST methods return the same response format. The POST method provides more personalized content in the Activity Intelligence field.

{
  "responseId": "123e4567-e89b-12d3-a456-426614174000",
  "activity_intelligence": "For your Half Dome hike today, be prepared for significant elevation gain and exposed terrain. The combination of high altitude, bear activity, and lightning risk requires careful planning. Start early and monitor weather conditions closely.",
  "risks": [
    {
      "id": "high-altitude",
      "title": "High Altitude",
      "source": "environment",
      "status": "applicable",
      "score": 3,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "sunburn",
      "title": "Sun Exposure",
      "source": "environment",
      "status": "applicable",
      "score": 2,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "lightning",
      "title": "Lightning",
      "source": "environment",
      "status": "applicable",
      "score": 1,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "bears",
      "title": "Bears",
      "source": "wildlife",
      "status": "applicable",
      "score": 2,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "frostbite",
      "title": "Frostbite",
      "source": "environment",
      "status": "not_applicable",
      "score": 0,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "poison-sumac",
      "title": "Poison Sumac",
      "source": "plants",
      "status": "unavailable"
    }
  ],
  "alerts": []
}

Query Parameters

location

string

required

The latitude and longitude, formatted as {latitude},{longitude}.

Pattern: ^-?\d+(\.\d+)?,-?\d+(\.\d+)?$

options.length

enum<string>

default:standard

Controls the length of the Activity Intelligence text.

Available options:

brief,

standard,

detailed

options.exclude

string

Comma-separated list of sections to exclude from the response. Options: alerts, environment, wildlife, plants, activity_intelligence

Response

A basic overview of all risks with default settings.

responseId

string<uuid>

required

A unique identifier for this response

activity_intelligence

string

required

An AI-generated summary paragraph that consolidates all risks and alerts

risks

object[]

required

A comprehensive array of all risks from environmental, wildlife, and plant sources

Option 1
Option 2

Show child attributes

alerts

object[]

An array of active NOAA weather alerts for the United States

Show child attributes

Current Risks

Forecasted Risks

Other

Simple Request (GET)

Headers

Query Parameters

Example

Advanced Request (POST)

Headers

Body Parameters

Response

Example

Response

Query Parameters

Response

​Simple Request (GET)

​Headers

​Query Parameters

​Example

​Advanced Request (POST)

​Headers

​Body Parameters

​Response

​Example

​Response

Query Parameters

Response

Simple Request (GET)

Headers

Query Parameters

Example

Advanced Request (POST)

Headers

Body Parameters

Response

Example

Response