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

# Get Shared Layer Columns Metadata

`GET /api/v1/share/{share_token}/layers/{layer_id}/columns`

Share-scoped column metadata + aggregate stats. Mirrors
``table_handlers.get_layer_columns_metadata`` with a share-token guard.

## Path parameters

- `share_token` string, required
- `layer_id` string, uuid, required

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