{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://publicschema.org/OwnershipInterest.schema.json",
  "title": "OwnershipInterest",
  "description": "A stated ownership or control interest that a person, organization or legal arrangement holds in an organization or legal arrangement, such as a shareholding or voting rights. Separate interests may coexist. An indirect interest may list the direct interests that make up its route. Recording an interest does not decide who is a beneficial owner under any law; a source's conclusion is recorded separately, with the legal definition it applies.",
  "type": "object",
  "properties": {
    "interest_holder": {
      "type": "string",
      "format": "uri",
      "description": "The URI of the person, organization or legal arrangement that holds the interest."
    },
    "interest_entity": {
      "type": "string",
      "format": "uri",
      "description": "The URI of the organization or legal arrangement in which the interest is held. A person is never the entity in which an interest is held."
    },
    "interest_type": {
      "$ref": "https://publicschema.org/CodedValue.schema.json",
      "description": "How the interest is held or exercised, such as shares, voting rights or the right to appoint the board. Codes from the Beneficial Ownership Data Standard interestType codelist are recommended; a jurisdiction's own scheme can be used for interests that list does not cover."
    },
    "interest_directness": {
      "type": "string",
      "enum": [
        "direct",
        "indirect",
        "unknown"
      ],
      "$comment": "https://publicschema.org/vocab/interest-directness",
      "description": "Whether the interest is held directly, through intermediate entities or arrangements, or with unknown directness."
    },
    "interest_percentage": {
      "type": "number",
      "description": "An exact asserted percentage for this interest, on a scale from zero to one hundred. Omit when only a band or uncertain amount is known; preserve that qualification in interest_description.",
      "minimum": 0,
      "maximum": 100
    },
    "interest_minimum_percentage": {
      "type": "number",
      "description": "An inclusive lower percentage bound for an asserted interest on a zero-to-one-hundred scale. This is a bound, not an exact value; omit when unknown.",
      "minimum": 0,
      "maximum": 100
    },
    "interest_exclusive_minimum_percentage": {
      "type": "number",
      "description": "A percentage strictly below the asserted interest, on a zero-to-one-hundred scale. An interest exceeding twenty-five percent may use 25 here without inventing an exact amount. This is alternative to an inclusive lower bound.",
      "minimum": 0,
      "maximum": 100
    },
    "interest_maximum_percentage": {
      "type": "number",
      "description": "An inclusive upper percentage bound for an asserted interest on a zero-to-one-hundred scale. Omission means that this upper bound was not supplied; it does not imply an exact amount.",
      "minimum": 0,
      "maximum": 100
    },
    "interest_exclusive_maximum_percentage": {
      "type": "number",
      "description": "A percentage strictly above the asserted interest, on a zero-to-one-hundred scale. This is alternative to an inclusive upper bound and never an exact percentage.",
      "minimum": 0,
      "maximum": 100
    },
    "interest_description": {
      "type": "string",
      "description": "The local name for the interest or other details that explain it, such as bounds or uncertainty that the percentage slots cannot express."
    },
    "component_interests": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/OwnershipInterest.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "The direct interests that together make up this indirect interest, each with its own holder, entity and period. Listing them does not verify the route or calculate an effective share."
      }
    },
    "beneficial_ownership_or_control": {
      "type": "boolean",
      "description": "Whether the source concluded that this interest amounts to beneficial ownership or control, as in the Beneficial Ownership Data Standard beneficialOwnershipOrControl field. It is a legal conclusion under the definition named in beneficial_ownership_definition, and is stated only with it. False records a conclusion that the interest does not qualify; an absent value means that no conclusion is recorded."
    },
    "beneficial_ownership_definition": {
      "type": "string",
      "format": "uri",
      "description": "The URI of the legal provision or guidance that defines beneficial ownership or control for the conclusion in beneficial_ownership_or_control, such as a national anti-money-laundering law."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "The date on which this became effective."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "The last day on which this is effective. A period includes both its start date and its end date, so a period that applies only on 30 June 2026 has start date 2026-06-30 and end date 2026-06-30."
    }
  }
}