---
title: "List canonical data assets"
method: GET
path: "/api/v1/data/catalog"
tags: ["Data"]
---

# List canonical data assets

`GET /api/v1/data/catalog`

## Request

- Base URL: `https://worldcastr.com`
- URL: `https://worldcastr.com/api/v1/data/catalog`
- Auth: none required

Matrix-backed canonical data-asset catalog spanning public, metadata-only, restricted, and unavailable Worldcastr data surfaces.

## Query parameters

- `asset_id` string
- `data_family` string
- `public_status` string
- `visibility` 'public' | 'metadata_only' | 'restricted' | 'unavailable'
- `inventory_asset` string

## Response `200`

Canonical data asset catalog

- object
  - `schema_id` string
  - `schema_version` string
  - `data_snapshot_id` string
  - `family_count` integer
  - `filters` object
  - `records` DataAssetRecord[]
    - `asset_id` string, required
    - `title` string, required
    - `description` string, required
    - `data_family` string, required
    - `raw_source_or_access` string, required
    - `example_internal_artifacts` string
    - `support_level` string, required
    - `targets_or_fields` string, required
    - `pipeline_state` string, required
    - `public_status` string, required
    - `sensitivity` string, required
    - `visibility` 'public' | 'metadata_only' | 'restricted' | 'unavailable', required
    - `license_status` string, required
    - `recommended_public_surface` string, required
    - `public_data_inventory_asset` string, nullable
    - `payload_availability` DataPayloadAvailability
      - `level` 'metadata_only' | 'sample_rows' | 'queryable_rows' | 'bulk_download' | 'restricted' | 'unavailable', required
      - `metadata_available` boolean, required
      - `sample_rows` boolean, required
      - `queryable_rows` boolean, required
      - `bulk_download` boolean, required
      - `runtime_verification` 'contract_declared', required
      - `reason` string, required
    - `current_surfaces` object, required
      - `rest` string, nullable, required
      - `mcp` string, nullable, required
      - `openapi` string, required
      - `docs` string, required
      - `sdk` string, required
    - `canonical_profile` object, required
      - `source_contract` string, required
      - `canonical_contracts` string[], required
      - `raw_retention` string, required
      - `normalization` string[], required
      - `engineering` string[], required
      - `synthesis_policy` string, required
      - `delivery` string, nullable
    - `delivery_targets` object, required
      - `rest` string[], required
      - `mcp` string[], required
      - `openapi` string[], required
      - `docs` string[], required
      - `sdk` string[], required
      - `export_formats` string[], required
    - `inventory_asset` DataInventoryAssetSummary
      - `asset_id` string, required
      - `title` string, required
      - `phase` string, required
      - `public_readiness` string, required
      - `benchmark_role` string, required
      - `model_version` string, nullable
      - `training_eligibility` 'benchmark_only' | 'consumer_feed' | 'training_candidate' | 'holdback', required
      - `example_path` string, nullable
    - `related_artifact_ids` string[], required
    - `related_provenance_ids` string[], required
    - `gap_or_blocker` string, required
    - `next_step` string, required
    - `provenance` DataProvenanceSummary, required
      - `provenance_id` string, required
      - `data_snapshot_id` string, required
      - `publication_date` string, date, nullable
      - `retrieval_date` string, date, nullable
      - `model_version` string, nullable
      - `license_note` string, required
    - `access` DataAccessSummary, required
      - `visibility` 'public' | 'metadata_only' | 'restricted' | 'unavailable', required
      - `support_level` string, required
      - `sensitivity` string, required
      - `training_eligibility` 'benchmark_only' | 'consumer_feed' | 'training_candidate' | 'holdback', required
      - `license_status` string, required
    - `_links` object, required
  - `page` object
  - `provenance` DataProvenanceSummary
    - `provenance_id` string, required
    - `data_snapshot_id` string, required
    - `publication_date` string, date, nullable
    - `retrieval_date` string, date, nullable
    - `model_version` string, nullable
    - `license_note` string, required
  - `access` DataAccessSummary
    - `visibility` 'public' | 'metadata_only' | 'restricted' | 'unavailable', required
    - `support_level` string, required
    - `sensitivity` string, required
    - `training_eligibility` 'benchmark_only' | 'consumer_feed' | 'training_candidate' | 'holdback', required
    - `license_status` string, required
  - `_links` object

## Other responses

- `404`: Unknown asset_id

---

[API](https://skmtc.dev/worldcastr/apis/worldcastr-api.md) · [All operations](https://skmtc.dev/worldcastr/apis/worldcastr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldcastr/apis/worldcastr-api/revisions/2cf1606dc8e1?raw)