ITMOField Guide
API overviewMap & Images

Get map hexagons for a day

GET
/map/{date}

Map data for a specific day as a flat list of H3 hexagon cells. A day with no data returns an empty data array. A date that is not in YYYY-MM-DD form does not match this route and returns 404.

Supports conditional GET (ETag / If-None-Match).

Path Parameters

date*string

The day to fetch, as YYYY-MM-DD.

Match^\d{4}-\d{2}-\d{2}$

Header Parameters

If-None-Match?string

The ETag from an earlier response. If the data has not changed you get an empty 304 Not Modified.

Response Body

Hexagon cells for the day.

application/json
  1. response
data*array<>
meta*
Example Request
curl -X GET 'https://api.isthemountainout.com/v1/map/2026-08-15' \  -H 'If-None-Match: "5d41402abc4b2a76b9719d911017c592"'
Example Response
{  "data": [    {      "h3_index": "8628f015fffffff",      "reports": 12,      "mountain_not_out": 8,      "mountain_out": 4,      "state_counts": {        "mountain_not_out": 8,        "mountain_peaking_out": 0,        "mountain_halfway_out": 0,        "mountain_mostly_out": 0,        "mountain_out": 4      },      "dominant_state": "mountain_not_out",      "dominant_state_percentage": 33.3,      "fill_color": "#efe",      "outline_color": "#efe",      "opacity": 1,      "grayscale": 0    }  ],  "meta": {    "generated_at": "2026-08-15T20:14:09+00:00"  }}