GET/territories/{id}/{version}/layers/{addr}/{file}

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

What it does

Unlike the small metadata routes, layer blobs are ~1 GB each, so they are byte-metered against the calling identity's monthly download allowance (DownloadMeter). Provisional keys are blocked (403); operator (admin) keys, which carry no identity, are not metered.

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/territories/{id}/{version}/layers/{addr}/{file}" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
id	path	yes	Territory id
version	path	yes	Published package version
addr	path	yes	Blob address: 16 lowercase hex chars of the layer's BLAKE3
file	path	yes	Blob file name, e.g. `valhalla.tar.zst`

Responses

200The layer blob (tar + zstd)

206Partial content for a Range request

304Not modified

402Monthly offline-download allowance exhausted; body carries a machine-readable download_allowance_exceeded upgrade pointer

403Provisional key: territory downloads require a verified account

404Unknown territory, version or blob

416Unsatisfiable Range

Error bodies follow the shared problem model documented on API conventions.

Also under territories

GET /territories GET /territories/{id}/{version}/manifest GET /territories/{id}/{version}/manifest.sig GET /territories/index.sig

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId get_layer