Skip to content

50,000 free calls a month, card-free. Get an API key →

Documentation menu
docs / api / get-territories
territories

GET/territories

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

What it does

Each territory in the index carries data_updated: the ISO-8601 date (YYYY-MM-DD) of the OSM extract behind its latest_version, or null on a channel published before the field existed. The gateway adds nothing here either; the field is written and signed by snfactory publish (sn_factory::channel), so it cannot drift from the manifests it summarises, and a client can verify it against them.

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/territories" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Responses

200The channel index (index.json, exact signed bytes); each territory carries data_updated, the ISO-8601 date of the OSM extract behind its latest version (null if unknown)
304Not modified (If-None-Match matched the BLAKE3 ETag)
404No update channel configured on this gateway

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

Also under territories

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