{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://publicschema.org/RepresentationRole.schema.json",
  "title": "RepresentationRole",
  "description": "A dated relationship in which a person or organization acts on behalf of a person, organization, group or legal arrangement within a stated scope. Representation is distinct from identity, and recording it does not prove that the representative may take a particular action. A receiving authority can check a mandate that states its powers as codes, its legal basis in legal resources and the instrument that grants it as evidence.",
  "type": "object",
  "properties": {
    "representative": {
      "oneOf": [
        {
          "$ref": "https://publicschema.org/Agent.schema.json"
        },
        {
          "type": "string",
          "description": "URI or identifier reference"
        }
      ],
      "description": "The person or organization acting on behalf of the represented party."
    },
    "represented": {
      "type": "string",
      "format": "uri",
      "description": "The URI of the person, organization, group or legal arrangement on whose behalf the representative acts, such as a household applying through one of its members or a trust acting through its trustees."
    },
    "representation_scope": {
      "type": "string",
      "description": "The matters for which, and the limits within which, the representative may act, such as communication about a specified tax regime."
    },
    "representation_powers": {
      "type": "array",
      "items": {
        "$ref": "https://publicschema.org/CodedValue.schema.json",
        "description": "The acts the representative may perform for the represented party, each coded in a named scheme, such as a tax authority's list of authorization types or the powers listed on a power of attorney form. A receiving authority checks them against its own rules; a code does not by itself grant authority to take any action."
      }
    },
    "legal_resources": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "description": "Identified legal provisions or policy resources that a service, organization, decision, measure, representation or institutional change relies on. A link does not execute a rule or establish which version is applicable. For the legal basis for processing personal data, use legal_basis."
      }
    },
    "evidence_assertions": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/EvidenceAssertion.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "Statements identifying sources that support or contradict this statement."
      }
    },
    "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."
    }
  }
}
