Skip to content

GET /v1/tiles/.../tilejson.json

Returns a TileJSON 3.0.0 document that points at the tile route.

Method and path GET /v1/tiles/{presetId}/{tileMatrixSetId}/tilejson.json
Key not needed (the tiles it points at need one)
Response application/json
Lean OpenAPI getTileJson
Full contract getTileJson

The tile route’s, without z, x, y and format: presetId, tileMatrixSetId, and the query parameters collection, datetime, maxCloudCoverage, harmonize and tilesize. The tiles template is a PNG URL that repeats the query parameters you send.

Terminal window
curl -s "https://api.satellitedata.net/v1/tiles/ndvi/WebMercatorQuad/tilejson.json?collection=sentinel-2-l2a&datetime=2026-06-01T00:00:00Z/2026-08-31T23:59:59Z&maxCloudCoverage=40"

Response shape:

{
"tilejson": "3.0.0",
"name": "ndvi",
"description": "NDVI from sentinel-2-l2a, 2026-06-01T00:00:00Z/2026-08-31T23:59:59Z, scenes under 40% cloud.",
"version": "lean-1",
"attribution": "Contains modified Copernicus Sentinel data 2026",
"scheme": "xyz",
"tiles": [
"https://api.satellitedata.net/v1/tiles/ndvi/WebMercatorQuad/{z}/{x}/{y}.png?collection=sentinel-2-l2a&datetime=2026-06-01T00%3A00%3A00Z%2F2026-08-31T23%3A59%3A59Z&maxCloudCoverage=40"
],
"minzoom": 8,
"maxzoom": 15,
"bounds": [-180, -85.0511, 180, 85.0511],
"center": [0, 0, 8]
}

minzoom and maxzoom are the collection’s: 8 to 15 for Sentinel-2, 7 to 14 for Landsat. version is the render version.

Status Code When
400 invalid-parameter an unknown tile matrix set or query parameter, or a collection the preset does not accept
404 not-found no such preset
422 harmonize-unavailable harmonize other than offset_removed