Coming Soon — This endpoint is under development and will be available at a future date.
This endpoint allows you to check for wildlife-related health risks based on a specific location. You can check for all wildlife risks or specify particular ones.
Request
Your API key for authentication. Format: Bearer YOUR_API_KEY
Query Parameters
The latitude and longitude for the location to check, formatted as {latitude},{longitude}.
A comma-separated list of wildlife risk IDs to check. If you do not provide this, all wildlife risks will be checked.
The available ids are:
bears
venomous-snakes
mosquitoes
ticks
Response
The response is a JSON object containing a responseId and a risks array. Each object in the array represents a specific wildlife risk and includes an id, a title, a score, and a list of tips.
A unique identifier for this response. Use this ID if submitting feedback about the response.
An array of risk objects. The unique identifier for the risk. Example: bears.
The human-readable title of the risk. Example: Bears.
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
A number from 0-3 representing the prevalence of this wildlife in the area:
0: None
1: Low
2: Medium
3: High
A collection of 1-2 sentence strings with tips and recommendations.
A 1-2 sentence summary of the tips and key information.
Error message describing what went wrong. Only present when status is error.
Example
Request
curl "http://api.goes.health/v1/risks/wildlife?ids=bears,venomous-snakes&location=34.0522,-118.2437" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"responseId" : "123e4567-e89b-12d3-a456-426614174000" ,
"risks" : [
{
"id" : "bears" ,
"title" : "Bears" ,
"status" : "applicable" ,
"score" : 2 ,
"summary" : "..." ,
"tips" : [
"..."
]
},
{
"id" : "venomous-snakes" ,
"title" : "Venomous Snakes" ,
"status" : "applicable" ,
"score" : 1 ,
"summary" : "..." ,
"tips" : [
"..."
]
}
]
}
The latitude and longitude, formatted as {latitude},{longitude} .
A comma-separated list of wildlife risk IDs.
Comma-separated list of sections to exclude from the response. Options: tips , summary , score
A list of wildlife risks.
A unique identifier for this response