# Vlada ontology layer one (edge)

`vlada_ontology.l1_edge` · Curated datasets · status live · 279,515 rows

The Vlada ontology, layer one (who holds and who owns every Medicare, Medicaid and Marketplace instrument, over time), SIGNED by Ben on build v3o (2026-10-28; docs/architecture/ontology-v2/L1-SIGNOFF.md). Permanent IDs; a legal entity is not its brand nor the contract it holds; history is dated events with filings; every fact graded A/B/C with its evidence; two clocks. Built by tools/ontology2/build.py, served by tools/ontology2/serve.py (the view moves only to a signed build). Tools: resolve_entity, describe_entity; API: /v1/entities.

**Grain.** One row per SERVED dated relationship: held_by, reported_parent, member_of_group, owned_by, controlled_by (basis, grade), brand_of, merged_into, part_of, continues_as; from_basis, observed and confirmed windows; candidate and refuted rows never appear.

| column | type | meaning |
|---|---|---|
| rel | string |  |
| from_id | string |  |
| to_id | string |  |
| basis | string |  |
| valid_from | string |  |
| valid_to | string |  |
| grade | string |  |
| status | string |  |
| event_id | string |  |
| evidence_id | string |  |
| recorded_version | string |  |
| from_basis | string |  |
| observed_from | string |  |
| observed_to | string |  |
| confirmed_to | string |  |
| confirmed_by | string |  |

Tools that read it: describe_entity, resolve_entity

Query it: `query_substrate` with `SELECT ... FROM vlada_ontology.l1_edge WHERE ... LIMIT 100`; read `describe_data_source("vlada_ontology.l1_edge")` first.