Skip to content

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

Documentation menu
docs / api / get-tiles-territory-z-x-y-mvt
tiles

GET/tiles/{territory}/{z}/{x}/{y}.mvt

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

What it does

One vector tile. The .mvt extension is required (.pbf is also accepted); a URL without an extension is a 404.

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/tiles/{territory}/{z}/{x}/{y}.mvt" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

NameInRequiredDescription
territorypathyesTerritory id, e.g. uk
zpathyesZoom level
xpathyesTile column
ypathyesTile row. The path continues with .mvt (or .pbf), for example /tiles/uk/12/2047/1362.mvt

Responses

200One Mapbox Vector Tile
204No data for this tile (empty tile)
304Not modified (If-None-Match matched the ETag)
404Tiles not configured, unknown territory, or out-of-range tile

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

Also under tiles

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