Log in Get an API key

Documentation menu

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

Tiles, styles and map assets

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

Auth	An API key, as `Authorization: Bearer snk_…` or `?api_key=snk_…`. Metered. A browser (`maps`) key may call it.
Price	Discounted: 1 call per 50 tile, TileJSON or style requests per key on the hosted gateway (`SN_TILE_METER_DIVISOR`); at the quota ceiling every request bills in full. Class: standard. Published as `unit_rules.tiles` in /pricing.json.

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

Name	In	Type	Required	Description
territory	path	string	yes	Territory id, e.g. `uk`
z	path	integer	yes	Zoom level Limits: at least 0.
x	path	integer	yes	Tile column Limits: at least 0.
y	path	integer	yes	Tile row. The path continues with `.mvt` (or `.pbf`), for example `/tiles/uk/12/2047/1362.mvt` Limits: at least 0.

Responses

200One Mapbox Vector Tile

204No data for this tile (empty tile)

304Not modified (If-None-Match matched the ETag)

401No key, or a missing, malformed, unknown, revoked or expired one (unauthorized); the body carries signup, docs and a one-call hint for a free key

application/problem+json · Problem

402Beyond the included volume with no way to pay this call: an x402 body naming how to pay (provisional key past its allowance, prepaid balance below the price, or a rejected X-PAYMENT). Not problem+json

application/json · X402PaymentRequired

403The key may not call this: a browser key outside its scope (scope-insufficient), a request from an origin the key does not allow (origin-not-allowed), or an account restriction (forbidden)

application/problem+json · Problem

404Tiles not configured, unknown territory, or out-of-range tile

application/problem+json · Problem

429Per-key rate limit (rate-limited, with Retry-After), or monthly quota exhausted with no payment path (quota-exceeded)

application/problem+json · Problem

504The request did not finish within the gateway's request deadline (request-timeout)

application/problem+json · Problem

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

Also under Tiles, styles and map assets

GET /avatars/{version}/{path}GET /fonts/{fontstack}/{range}GET /pointclouds/{dataset}/{file}GET /sprite/{file}GET /styles POST /styles DELETE /styles/{spec}GET /styles/{spec}POST /styles/{spec}GET /styles/{spec}/theme GET /tiles/{territory}/style.json GET /tiles/{territory}/tiles.json GET /v1/static-map POST /v1/static-map

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