Every endpoint, with examples.

Vector or raster tile from a tileset.

drop-in /tiles/{id}/{z}/{x}/{y}.{ext}

Tilequery — features near a point from a vector tileset (radius, limit, layers, geometry, dedupe).

drop-in /v4/{id}/tilequery/{lng},{lat}.json

MapLibre GL style document.

drop-in /styles/{id}/style.json

Server-rendered static map image (bbox/auto + markers/path/geojson too).

drop-in /maps/{id}/static/…

Forward or reverse ({lng},{lat}) geocoding; batch with “;”.

drop-in /geocoding/{query}.json

Directions; also /v1/route/matrix/… and /v1/route/isochrone/…. profile = driving | walking | cycling.

drop-in /directions/v5/{profile}/{coords}

Elevation in metres at a point.

drop-in /elevation/{lng},{lat}.json

Vector tile (MVT) from a tileset; .pbf accepted as an alias.

• id Tileset id
• z / x / y Tile coordinates

Raster tile from a raster tileset (e.g. ingested GeoTIFF imagery).

TileJSON 3.0 (vector or raster, by the archive type).

Tilequery: features near a point from a vector tileset (Mapbox-compatible). Params: radius (m), limit, layers, geometry, dedupe.

• id Vector tileset id
• lng,lat Query point
• radius Search radius in metres (default 0)
• limit Max features (default 5, max 50)

Images API alias for a raster tileset (+ /images/{id}/image.json). standard, extension inferred.

Aerial imagery tile (proxied Esri World Imagery).

Terrarium-encoded DEM tile for hillshade.

MapLibre style with absolute, keyed URLs resolved.

drop-in compatible alias of /styles/{id}/style.json.

Glyph range PBF for a font stack.

Sprite sheet metadata (.json) and image (.png).

Reverse geocode a coordinate (Nominatim-backed).

POI details near a coordinate — name, kind, address, and extratags (opening_hours, website, phone) where available.

Forward search / autocomplete (text query); types= filters result categories.

• limit Max results, 1–10 (default 5)
• proximity {lng},{lat} to bias results
• bbox {w},{s},{e},{n} to restrict results
• country ISO country code(s) to restrict
• language Preferred result language

Batch forward geocoding (up to 50; URL-encode the “;”). Returns an array of FeatureCollections.

Look up a feature by its id (kind.id) from a prior result.

Turn-by-turn route. profile = driving | walking | cycling. coordinates = lng,lat;lng,lat;… (max 25).

• geometries polyline (default) · polyline6 · geojson
• steps true to include per-maneuver steps
• alternatives true to request alternate routes
• language Instruction language

N×M duration (and distance) matrix between waypoints. coordinates = lng,lat;… (max 25).

• sources all (default) or ;-separated coord indices
• destinations all (default) or ;-separated coord indices
• annotations duration (default), distance, or both

Map matching — snap a GPS trace to the road network (Mapbox shape). coordinates = lng,lat;… (max 100). Native: /v1/route/match/{profile}/{coords}.json.

• geometries polyline (default) · polyline6 · geojson
• steps true to include per-maneuver steps

Optimization / TSP — order intermediate stops for the shortest trip (Mapbox shape). coordinates = lng,lat;… (max 12). Native: /v1/route/optimize/{profile}/{coords}.json.

• geometries polyline (default) · polyline6 · geojson

Reachability polygons from a point. coordinates = lng,lat.

• contours_minutes Comma-separated time budgets, e.g. 10,20
• contours_meters Comma-separated distance budgets (alt. to minutes)
• contours_colors Comma-separated hex colors per contour
• polygons true (default) for polygons, false for lines

Render a static image. Also at /styles/{id}/static/…. @2x doubles the pixel size. markers / path / geojson overlays supported.

• position Point {lon},{lat},{zoom} · bbox {w},{s},{e},{n} · or auto (fit overlay)
• markers lon,lat[,color] — repeatable or ;-separated
• path lon,lat|lon,lat|… polyline (repeatable)
• path-color / path-width Polyline stroke colour and width
• padding Edge padding (px) for bbox / auto framing

512px rendered tile (1024px at @2x). Also /maps/{id}/… and /{id}/256/… for 256px tiles.

Raster TileJSON (tileSize 512) for the rendered tiles.

RESTful capabilities document for a style.

RESTful tile (TileMatrix = z, TileRow = y, TileCol = x).

KVP endpoint: REQUEST=GetTile or GetCapabilities (LAYER, TILEMATRIX, TILEROW, TILECOL, FORMAT).

Capabilities document listing every style as a layer.

Render an arbitrary bounding box to an image.

• LAYERS Style id
• CRS / SRS EPSG:3857 · EPSG:4326 (1.3.0 lat,lon) · CRS:84
• BBOX minx,miny,maxx,maxy in the CRS axis order
• WIDTH / HEIGHT Image size in pixels
• FORMAT image/png or image/jpeg

Elevation in metres at a point (decoded from the Terrarium DEM).

Transform coordinates between CRSes (EPSG:4326, EPSG:3857). Also at /coordinates/transform/{coords}.json?s_srs&t_srs (standard tile-API shape).

• from / to CRS, e.g. EPSG:4326 or 3857
• coords x,y or ;-separated x,y;x,y

Search common coordinate reference systems by name or EPSG code.

IP → location (country, city, lat/lng, timezone). Needs a GeoIP DB (GEOIP_DB); 503 if unset.

Hosted GeoJSON dataset (RFC 7946). Upload via POST /admin/data (admin).

The dataset served as MVT vector tiles (+ /data/{id}/tiles.json).

OGC API Tiles — list collections (one per tileset).

OGC API Tiles — a tile (TileMatrix/TileRow/TileCol = z/y/x).

List tilesets.

Upload .pmtiles (→ 201) or .mbtiles (→ 201 inline, or 202 + a background convert job when large). A GeoTIFF .tif → 202 + a background ingest job that retiles it to raster. Multipart: file, id, name.

Register a live PostGIS vector source ({ id, name, config:{ url, table, geomColumn, srid, layer, attributes[] } }) — tiles come from ST_AsMVT.

Register a virtual tileset ({ id, name, sources:[…] }) — combines the MVT layers of several vector tilesets per tile.

Download the original .pmtiles archive.

Delete a tileset and its file.

List hosted GeoJSON datasets.

Create a dataset ({ id?, name, data: GeoJSON FeatureCollection }).

Delete a dataset.

List styles (metadata only).

Get a style including its document.

Create a style ({ id?, name, style, tilesetId? }).

Replace a style.

Delete a style.

List keys with trailing-24h usage.

Create a key ({ name, scopes[], origins[] }).

Revoke a key.

List recent jobs.

Get a job with its full log.

Queue a fetch ({ type, tilesetId, name, bbox?, maxzoom? }).

Read server settings.

Update settings (public URL, CORS, cache TTL, …).

Clear the in-memory tile cache.

Recent request log (filter=all|errors|misses, limit≤500).

Liveness + database status + version. No auth.

Prometheus metrics (no auth) — per-route latency + request counts, plus mapwright_disk_bytes (data/Valhalla volumes), mapwright_responses_total{class} (2xx/4xx/5xx), mapwright_jobs{status}, and tile-cache hit/miss gauges. Scope to your monitoring host at the proxy.