---
title: "Get Layer Mvt Tile"
method: GET
path: "/api/v1/map/{layer_id}/tiles/{z}/{x}/{y}.pbf"
tags: ["map"]
---

# Get Layer Mvt Tile

`GET /api/v1/map/{layer_id}/tiles/{z}/{x}/{y}.pbf`

Serve an MVT tile for a layer.

``v`` is a client-supplied cache-busting token — change it (e.g., to a
timestamp) when you know the underlying data has moved. ``filter_id``
references a server-side FilterSpec (POSTed via ``/filters``); when
present, the tile contains only matching rows. Favorites-only filtering
pulls the user's favorite ids inline so the tile WHERE-clause includes
them — without that, the tile would visually drop the favorites filter
even though the table respects it. ``viz`` names a layer column to embed
as a feature property at every zoom (below the include-all zoom only the
core name/owner/address columns ship otherwise) so the client can drive a
value-weighted visualization; unknown columns are dropped silently.

## Path parameters

- `z` integer, required
- `x` integer, required
- `y` integer, required
- `layer_id` string, uuid, required

## Query parameters

- `v` string
- `filter_id` string, uuid, nullable
- `viz` string, nullable
- `token` string, nullable — Firebase ID token for MVT authentication

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/0382310d5ade/schema)