---
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.

## 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

## Changes

- **2026-09-12** `604ea84d0ff7` — 1 warning, 1 info
  - deleted the `query` request parameter `token`
  - removed the non-success response with the status `422`
- **2026-09-10** `97ae7fd86d44` — 1 info
  - added the required property `columns/additionalProperties/attribution` to the response with the `200` status

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/table/:layer_id/columns/get.md)

---

[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.dev/maia-analytics/apis/maia-api/revisions/8dc47faf0418?raw)