---
title: "Get Example Table"
method: GET
path: "/v2/polaris/datasets/{dataset_id}/example-table"
tags: ["Polaris"]
---

# Get Example Table

`GET /v2/polaris/datasets/{dataset_id}/example-table`

Resolve the animal-name namespace and a representative table for a dataset.

Pre-filled context (cut/lag provided): uses the entitled SKU.
Dropdown context (cut/lag omitted): returns any table from the graph.

``catalog`` selects which polaris catalog to source the example from. The
SQL editor's "Connect your query engine" entry passes ``sample`` so the
example reflects the lagged tables actually populated in the sample
warehouse the user just queried; everything else defaults to ``bulk``.

Auth + per-client entitlement are enforced by the parent ``router`` in
``api.py`` (bearer token via ``get_authenticated_user`` plus
``_require_example_table_access``, which 404s datasets denied to the caller
or globally disabled); no redundant per-endpoint dep needed here.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `cut` string, nullable
- `lag` string, nullable
- `catalog` string

## Response `200`

Successful Response

- ExampleTableResponse
  - `namespace` string, required
  - `table` string, required

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/revisions/bd33ea42994c/schema)