{
  "$comment": "Canonical master-data schema contract document: the committed source of the get_master_data_schema tool result (BUILD.md 8.2), registered in contract/release-surfaces.json. Language-neutral by contract: every implementation embeds this file and serves its values verbatim, never a per-language rendering, and nothing here is ever paraphrased, reworded, truncated, or extended. The entity types, identifier systems, attributes, relationships, and reference-domain names below are v1 data-model vocabulary — the definitions an agent needs to choose and parameterise the paid tools — not claims that any source populates them. Which sources populate which systems, attributes, or domains is coverage, and per the honesty rule coverage reports only decided facts: no public source catalogue is published yet (open decision S1), so coverage stays empty and data_version is explicitly unpublished, and freshness is an explicit UNRESOLVED statement pending decision S9. This document names no source, no licence, no date, and no record count, and it never exposes a record collection. Every v1 attribute carries sensitivity public: the service publishes public data only. entity_types is kept in stable alphabetical order by name.",
  "schema_version": "1.0.0",
  "data_version": "unpublished",
  "entity_types": [
    {
      "name": "location",
      "description": "A physical or postal place — a site, facility, address, or port — that suppliers and organizations operate at. Locations form a hierarchy: a site sits inside a broader location.",
      "primary_identifier": "record_id",
      "identifiers": [
        {
          "system": "record_id",
          "description": "Service-assigned stable golden-record identifier, unique within the entity type. Use it as the record_id argument of get_master_data_golden_record and get_master_data_relationships, and as identifier system record_id in resolve_master_data_entity."
        },
        {
          "system": "unlocode",
          "description": "UN/LOCODE code for locations that have one. Usable as an identifier system in resolve_master_data_entity."
        }
      ],
      "attributes": [
        {
          "name": "name",
          "type": "string",
          "description": "Common name of the location.",
          "searchable": true,
          "filterable": true,
          "sortable": true,
          "sensitivity": "public",
          "reference_domain": null
        },
        {
          "name": "address",
          "type": "string",
          "description": "Full postal address, as one governed text value.",
          "searchable": true,
          "filterable": false,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": null
        },
        {
          "name": "country",
          "type": "string",
          "description": "Country of the location, coded from the country reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": true,
          "sensitivity": "public",
          "reference_domain": "country"
        },
        {
          "name": "status",
          "type": "string",
          "description": "Lifecycle status of the golden record, coded from the status reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": "status"
        }
      ],
      "relationships": [
        {
          "type": "located_in",
          "direction": "outbound",
          "target_entity_type": "location",
          "cardinality": "many_to_one"
        },
        {
          "type": "located_in",
          "direction": "inbound",
          "target_entity_type": "location",
          "cardinality": "one_to_many"
        },
        {
          "type": "located_at",
          "direction": "inbound",
          "target_entity_type": "supplier",
          "cardinality": "many_to_many"
        }
      ]
    },
    {
      "name": "organization",
      "description": "A legal entity or corporate body. Organizations form a parentage hierarchy and own suppliers.",
      "primary_identifier": "record_id",
      "identifiers": [
        {
          "system": "record_id",
          "description": "Service-assigned stable golden-record identifier, unique within the entity type. Use it as the record_id argument of get_master_data_golden_record and get_master_data_relationships, and as identifier system record_id in resolve_master_data_entity."
        },
        {
          "system": "lei",
          "description": "ISO 17442 Legal Entity Identifier for legal entities that have one. Usable as an identifier system in resolve_master_data_entity."
        }
      ],
      "attributes": [
        {
          "name": "legal_name",
          "type": "string",
          "description": "Registered legal name of the organization.",
          "searchable": true,
          "filterable": true,
          "sortable": true,
          "sensitivity": "public",
          "reference_domain": null
        },
        {
          "name": "country",
          "type": "string",
          "description": "Country of registration, coded from the country reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": true,
          "sensitivity": "public",
          "reference_domain": "country"
        },
        {
          "name": "industry",
          "type": "string",
          "description": "Industry classification, coded from the industry reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": "industry"
        },
        {
          "name": "status",
          "type": "string",
          "description": "Lifecycle status of the golden record, coded from the status reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": "status"
        }
      ],
      "relationships": [
        {
          "type": "subsidiary_of",
          "direction": "outbound",
          "target_entity_type": "organization",
          "cardinality": "many_to_one"
        },
        {
          "type": "subsidiary_of",
          "direction": "inbound",
          "target_entity_type": "organization",
          "cardinality": "one_to_many"
        },
        {
          "type": "owned_by",
          "direction": "inbound",
          "target_entity_type": "supplier",
          "cardinality": "one_to_many"
        }
      ]
    },
    {
      "name": "supplier",
      "description": "A party that supplies goods or services, owned by an organization and operating at one or more locations.",
      "primary_identifier": "record_id",
      "identifiers": [
        {
          "system": "record_id",
          "description": "Service-assigned stable golden-record identifier, unique within the entity type. Use it as the record_id argument of get_master_data_golden_record and get_master_data_relationships, and as identifier system record_id in resolve_master_data_entity."
        },
        {
          "system": "lei",
          "description": "ISO 17442 Legal Entity Identifier for legal entities that have one. Usable as an identifier system in resolve_master_data_entity."
        }
      ],
      "attributes": [
        {
          "name": "legal_name",
          "type": "string",
          "description": "Registered legal name of the supplier.",
          "searchable": true,
          "filterable": true,
          "sortable": true,
          "sensitivity": "public",
          "reference_domain": null
        },
        {
          "name": "trade_name",
          "type": "string",
          "description": "Trading or doing-business-as name.",
          "searchable": true,
          "filterable": true,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": null
        },
        {
          "name": "country",
          "type": "string",
          "description": "Country of registration, coded from the country reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": true,
          "sensitivity": "public",
          "reference_domain": "country"
        },
        {
          "name": "industry",
          "type": "string",
          "description": "Industry classification, coded from the industry reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": "industry"
        },
        {
          "name": "status",
          "type": "string",
          "description": "Lifecycle status of the golden record, coded from the status reference domain.",
          "searchable": false,
          "filterable": true,
          "sortable": false,
          "sensitivity": "public",
          "reference_domain": "status"
        }
      ],
      "relationships": [
        {
          "type": "owned_by",
          "direction": "outbound",
          "target_entity_type": "organization",
          "cardinality": "many_to_one"
        },
        {
          "type": "located_at",
          "direction": "outbound",
          "target_entity_type": "location",
          "cardinality": "many_to_many"
        }
      ]
    }
  ],
  "coverage": {
    "sources": [],
    "licenses": [],
    "statement": "No public sources are published yet: the public source catalogue, its licences, and per-source coverage are an open decision (S1). This section stays empty rather than inventing sources, licences, or record counts."
  },
  "freshness": {
    "status": "UNRESOLVED",
    "statement": "UNRESOLVED: freshness reporting is pending decision S9. No ingestion dates, publication dates, or update frequencies are decided, and none are invented here."
  },
  "public_use": {
    "allowed": true,
    "basis": "public-schema-metadata",
    "attribution_required": false,
    "restrictions": []
  }
}