---
title: "Describe a catalog fact"
method: GET
path: "/catalogs/{catalog}/facts/{name}"
---

# Describe a catalog fact

`GET /catalogs/{catalog}/facts/{name}`

Returns a single semantic metadata fact addressed by its name within a catalog.

## Path parameters

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

## 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, the fact from the catalog with the same name in the default environment will be returned.

## Response `200`

OK

- DescribeCatalogFactResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `environment` string, required — Environment containing the catalog definition.
  - `fact` 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)