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

# Dataset

`GET /catalog/{dataset}`

## Path parameters

- `dataset` string, required

## Response `200`

Successful Response

- DataDataset
  - `name` string, required — Stable dataset identifier used in SQL.
  - `kind` 'raw' | 'staging' | 'intermediate' | 'mart' | 'analysis' | 'cell' | 'provenance' | 'model' — Published dbt model layer. Non-mart layers appear only when explicitly customer-visible.
  - `domain` string, required — Business domain derived from the dbt model path.
  - `relation` string, required — Allowlisted relation to use in queries.
  - `description` string, required — Dataset definition from dbt.
  - `title` string, nullable — Human-readable dbt Dive title.
  - `documentation_url` string, nullable — Related Soria documentation URL.
  - `grain` string[], required — Declared columns that uniquely identify a row.
  - `snowflake_relation` string, nullable — SCHEMA.TABLE this dataset is delivered as in the Snowflake share.
  - `methodology` string, required — Methodology maintained with the dbt model.
  - `update_frequency` string, required — Expected publication cadence declared in dbt.
  - `providers` string[], required — Organizations providing the underlying data.
  - `source_links` SourceLink[], required — Canonical upstream documentation links.
    - `label` string, required — Human-readable label from the dbt customer publication metadata.
    - `url` string, required — Canonical provider documentation or dataset URL.
  - `sources` DatasetSource[], required — Recursive source-level lineage from the dbt graph.
    - `source` string, required — dbt source name.
    - `relation` string, required — Physical upstream relation declared by dbt.
    - `description` string, nullable — Source description from dbt.
    - `freshness` object, nullable — dbt source freshness policy, when set.
  - `columns` DatasetColumn[], required — Typed and documented dbt columns.
    - `name` string, required — Column name.
    - `type` string, required — Warehouse type declared in dbt.
    - `description` string, required — Column definition from dbt.
    - `accepted_values` unknown[] — Optional finite values declared in dbt column metadata.
      - unknown

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