---
title: "Catalog"
method: GET
path: "/catalog"
tags: ["data"]
---

# Catalog

`GET /catalog`

## Query parameters

- `query` string, nullable
- `domain` string, nullable

## Response `200`

Successful Response

- DataCatalog
  - `generated_at` string, required — When dbt regenerated this catalog metadata.
  - `datasets` DataDataset[], required — Published dbt datasets available on the governed data surface.
    - `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)