GET/pointclouds/{dataset}/{file}

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

What it does

Key-authenticated and scoped to the dataset's manifest (owning identity, listed keys, or public: anything else 404s). Supports a single bytes= Range (206 with Content-Range); metered in chunk units at the point-cloud discount: see the module docs.

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/pointclouds/{dataset}/{file}" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
dataset	path	yes	Dataset id, e.g. `acme-depot`
file	path	yes	Payload or sidecar file, e.g. `corridor-a.bin` or `corridor-a.json`

Responses

200The whole file

206The requested byte range

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

404Point clouds not configured, unknown dataset/file, or this key is not allowed this dataset

416Requested range not satisfiable

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

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