---
title: "List catalog facts"
method: GET
path: "/catalogs/{catalog}/facts"
---

# List catalog facts

`GET /catalogs/{catalog}/facts`

Lists the semantic metadata facts attached to a catalog, optionally filtered by scope and/or object path.

## Path parameters

- `catalog` string, required — The name of the catalog.

## Query parameters

- `environment` string — The environment of the catalog. Note that if a catalog with the requested name doesn't exist in the requested environment, facts for the catalog with the same name from the default environment will be returned.
- `scope` string — Filter facts by scope. When omitted, facts of every scope are returned.
- `object` string — Filter facts by object path (exact match). When omitted, facts about any object are returned.

## Response `200`

OK

- ListCatalogFactsResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `environment` string, required — Environment containing the catalog definition.
  - `facts` CatalogFact[], required
    - `body` unknown
    - `confidence` 'confirmed' | 'heuristic' | 'inferred', required — How trustworthy the fact is.
    - `created_at` string, date-time, required
    - `name` string, required — The natural key of the fact within the catalog.
    - `object` string, required — Descriptive path to what the fact is about, e.g. "bronze.runs.deleted_at". Empty for catalog-scoped facts.
    - `scope` 'catalog' | 'namespace' | 'table' | 'column' | 'metric', required — What kind of object the fact is about.
    - `source` string — Where the fact came from (agent id, user, ...).
    - `statement` string, required — The human-readable meaning of the fact.
    - `updated_at` string, date-time, required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/tower/apis/tower-api.md) · [All operations](https://skmtc.net/tower/apis/tower-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tower/tower-api/revisions/0e42b0fb26d9/schema)