---
title: "Get canonical entity metadata"
method: GET
path: "/api/v1/data/entities/{entity_id}"
tags: ["Data"]
---

# Get canonical entity metadata

`GET /api/v1/data/entities/{entity_id}`

## Request

- Base URL: `https://worldcastr.com`
- URL: `https://worldcastr.com/api/v1/data/entities/{entity_id}`
- Auth: none required

Returns one canonical geography entity with normalized ID namespace, parent hierarchy, labels, aliases, and source asset links.

## Path parameters

- `entity_id` string, required

## Query parameters

- `entity_type` string

## Response `200`

Canonical entity detail

- object
  - `schema_id` string
  - `schema_version` string
  - `data_snapshot_id` string
  - `record` DataEntityRecord
    - `entity_type` string, required
    - `entity_id` string, required
    - `id_namespace` string, nullable, required
    - `parent_entity_ids` string[]
    - `geometry_id` string, nullable
    - `geography_vintage` string, nullable
    - `display_name` string, required
    - `support_level` string, required
    - `labels` object, required
    - `aliases` string[], required
    - `source_asset_ids` string[], required
  - `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

- `400`: Invalid entity lookup
- `404`: Unknown entity

---

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