Authentication
Send your key as a bearer token or as a key query parameter. Use the header on servers and the query parameter in browser style URLs, where the key is visible anyway. Restrict browser keys to your origins in the dashboard.
Authorization: Bearer hx_live_8f2c...
GET /v1/tiles/planet-v4/11/1161/598.mvt?key=hx_live_8f2c...
Tiles
GET /v1/tiles/{tileset}/{z}/{x}/{y}.mvt returns a Mapbox Vector Tile in the XYZ scheme. Tilesets: planet-v4 (zoom 0 to 14, overzoom to 16) and contours-v2 (zoom 8 to 14). An empty tile returns 204.
| Header | Example | Meaning |
|---|---|---|
ETag | "p4-261105-a91c" | Tileset, build date and content hash. Send back in If-None-Match for a free 304. |
Cache-Control | public, max-age=3600 | Safe for shared caches and CDNs. |
X-Hx-Build | 261105 | Build date of the data in this tile. |
X-RateLimit-Remaining | 212 | Requests left in the current second. |
Styles and glyphs
GET /v1/styles/{name}.json returns a MapLibre style. Names: sand and graphite. Sprites live at /v1/sprites/{name}@2x.png and glyphs at /v1/glyphs/{fontstack}/{start}-{end}.pbf. Style URLs embed your key automatically when you request them with one.
Usage
GET /v1/usage?from=2026-11-01&to=2026-11-05 returns daily counts of origin requests, cache revalidations and bytes for the key that made the call. Numbers lag real time by up to 10 minutes.
{
"key": "hx_live_8f2c",
"from": "2026-11-01",
"to": "2026-11-05",
"requests": 3418207,
"revalidated": 22183004,
"bytes": 108421993344
}
Rate limits
Limits are per key and per second: 10 (Field), 50 (Survey), 250 (Atlas) and 1,000 or more (Meridian). Short bursts of up to twice the limit are tolerated. Beyond that the API returns 429 with a Retry-After header in seconds.
Errors
| Status | Code | What to do |
|---|---|---|
| 400 | bad_tile | Coordinates outside the tile grid or zoom out of range. |
| 401 | invalid_key | Key missing, revoked or restricted to another origin. |
| 403 | plan_required | The resource needs a higher plan. The body names it. |
| 429 | rate_limited | Back off for Retry-After seconds. |
| 503 | region_unavailable | Retry. Routing moves you to another region within seconds. |
All errors are JSON: {"error":"rate_limited","message":"Limit of 50 requests per second exceeded.","retry_after":2}.