---
title: "Dataset Metadata"
method: GET
path: "/catalog/{dataset}/metadata"
tags: ["data"]
---

# Dataset Metadata

`GET /catalog/{dataset}/metadata`

Return lightweight dbt metadata without columns, methodology, or table rows.

## Path parameters

- `dataset` string, required

## Response `200`

Successful Response

- DatasetMetadata
  - `name` string, required — Stable dataset identifier.
  - `kind` 'raw' | 'staging' | 'intermediate' | 'mart' | 'analysis' | 'cell' | 'provenance' | 'model' — Published dbt model layer.
  - `relation` string, required — Fully-qualified query relation.
  - `title` string, nullable — Human-readable dataset title.
  - `domain` string, required — Business domain.
  - `description` string, required — Dataset definition.
  - `grain` string[], required — Columns that uniquely identify a row, when documented.
  - `update_frequency` string, required — Expected source publication cadence.
  - `providers` string[], required — Underlying data providers documented in dbt.
  - `column_count` integer, required — Number of columns in the dbt contract.
  - `source_count` integer, required — Number of recursive upstream dbt sources.
  - `catalog_generated_at` string, required — When dbt regenerated this metadata. This is not the latest date present in the dataset.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/soriaanalytics/apis/soria-data-api.md) · [All operations](https://skmtc.dev/soriaanalytics/apis/soria-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/soriaanalytics/soria-data-api/revisions/e97615ca569b/schema)