---
title: "Get Layer Columns Metadata"
method: GET
path: "/api/v1/table/{layer_id}/columns"
tags: ["table"]
---

# Get Layer Columns Metadata

`GET /api/v1/table/{layer_id}/columns`

Column metadata + aggregate stats for a layer, without fetching row data.

## Query parameters

- `token` string, nullable — Firebase ID token for MVT authentication

## Response `200`

Successful Response

- ColumnsMetadataResponse — Response for GET /table/{layer_id}/columns. ``tile_url_template`` is a literal template; the client substitutes ``{layer_id}`` before handing the URL to Mapbox.
  - `tile_url_template` string, required
  - `total_rows` integer, required
  - `columns` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/ba2b8d962161/schema)