Skip to main content
GET
/
v1
/
risks
/
environmental
cURL
curl --request GET \
  --url https://api.goes.health/v1/risks/environmental \
  --header 'Authorization: Bearer <token>'
{
  "responseId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "risks": [
    {
      "id": "sunburn",
      "title": "Sunburn",
      "score": 2,
      "summary": "<string>",
      "tips": [
        "<string>"
      ],
      "error": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.goes.health/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows you to check for various outdoor health risks based on a specific location. You can check for all environmental risks or specify particular ones.

​
Request

​
Headers

​
Authorization
string
required
Your API key for authentication. Format: Bearer YOUR_API_KEY

​
Query Parameters

​
location
string
required
The latitude and longitude for the location to check, formatted as {latitude},{longitude}.
​
ids
string
A comma-separated list of risk IDs to check. If you do not provide this, all risks will be checked. The available ids are:
  • sunburn
  • high-altitude
  • heat-illness
  • breathing-problems
  • frostbite
  • hypothermia
  • lightning

​
Response

The response is a JSON object containing a risks array. Each object in the array represents a specific risk and includes an id, a title, a score, and a list of tips.
​
responseId
string
A unique identifier for this response. Use this ID if submitting feedback about the response.
​
risks
array
An array of risk objects.

​
Example

​
Request

curl "http://api.goes.health/v1/risks/environmental?ids=sunburn,heat-illness,frostbite&location=34.0522,-118.2437" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "responseId": "123e4567-e89b-12d3-a456-426614174000",
  "risks": [
    {
      "id": "sunburn",
      "title": "Sunburn",
      "status": "applicable",
      "score": 2,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "heat-illness",
      "title": "Heat Illness",
      "status": "applicable",
      "score": 3,
      "summary": "...",
      "tips": [
        "..."
      ]
    },
    {
      "id": "frostbite",
      "title": "Frostbite",
      "status": "not_applicable",
      "score": 0,
      "summary": "...",
      "tips": [
        "..."
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Enter your API key

Query Parameters

​
location
string
required

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

​
ids
string

A comma-separated list of environmental risk IDs.

​
exclude_risk_fields
string

Comma-separated list of sections to exclude from the response. Options: tips, summary, score

Response

A list of environmental risks.

​
responseId
string<uuid>

A unique identifier for this response

​
risks
object[]