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 |
Parameters
Section titled “Parameters”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.
Example
Section titled “Example”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.
Errors
Section titled “Errors”| 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 |