Provenance

Registry records are source-aware. The public API exposes that evidence through entity subroutes.

Entity Detail

GET /v1/entities/{idOrSlug}

Entity records include the public identity fields exported by Registry, such as id, slug, display name, entity type, environment, cycle and source-backed summary fields where available.

Facts

GET /v1/entities/{idOrSlug}/facts

Facts are atomic claims about an entity. Typical fact fields include:

Field	Meaning
entityId	Entity receiving the claim.
key	Fact key.
value	Typed value exported by Registry.
sourceId	Source that supports the fact.
sourceKind	Source category such as on-chain, World API or static client.
confidence	Confidence label.
environment	Environment scope.
cycle	Cycle scope where known.

Relations

GET /v1/entities/{idOrSlug}/relations

Relations connect entities. They are used for ownership, membership, routes, character-to-tribe evidence and other cross-record links.

Sources

GET /v1/entities/{idOrSlug}/sources
GET /v1/sources/{id}

Sources explain where public evidence came from. Examples include on-chain events, Sui objects, World API snapshots, static-client artefacts and reviewed public import artefacts.

Artefacts

GET /v1/artefacts/{id}

Artefacts are source files, snapshots or extraction outputs. They preserve evidence independently from normalised Registry records.

Confidence Labels

Registry exports use these confidence labels:

Label	Meaning
verified	Supported by a strong public source or reviewed import.
probable	Strongly indicated but not fully confirmed.
reported	Public report or observation requiring caution.
stale	Previously supported but likely superseded.
unknown	Confidence is not yet established.

Clients should display confidence, source kind and cycle context near user-facing claims.