---
title: "`GET /pointclouds/{dataset}/{file}`: one hosted payload (`.bin`) or sidecar (`.json`)."
method: GET
path: "/pointclouds/{dataset}/{file}"
tags: ["pointclouds"]
---

# \`GET /pointclouds/{dataset}/{file}\`: one hosted payload (\`.bin\`) or sidecar (\`.json\`).

`GET /pointclouds/{dataset}/{file}`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/pointclouds/{dataset}/{file}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

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.

## Path parameters

- `dataset` string, required
- `file` string, required

## Response `200`

The whole file

## Other responses

- `206`: The requested byte range
- `304`: Not modified (If-None-Match matched the ETag)
- `404`: Point clouds not configured, unknown dataset/file, or this key is not allowed this dataset
- `416`: Requested range not satisfiable

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)