From 76f09450577ced935f3ac6b287df11822ed8af0a Mon Sep 17 00:00:00 2001
From: haziqueiqbal12 <hazique.iqbal9@gmail.com>
Date: Fri, 24 Oct 2025 09:24:45 +0000
Subject: [PATCH] added reporting entity role in loan schema

---
 .../properties/reporting_entity_role.md       | 29 +++++++++++++++++++
 schemas/loan.json                             |  9 ++++++
 v1-dev/loan.json                              |  9 ++++++
 3 files changed, 47 insertions(+)
 create mode 100644 documentation/properties/reporting_entity_role.md

diff --git a/documentation/properties/reporting_entity_role.md b/documentation/properties/reporting_entity_role.md
new file mode 100644
index 00000000..34a48005
--- /dev/null
+++ b/documentation/properties/reporting_entity_role.md
@@ -0,0 +1,29 @@
+--
+layout:		property
+title:		"reporting_entity_role"
+schemas:	[loan]
+---
+
+# reporting_entity_role
+
+---
+
+The **reporting_entity_role** attribute identifies the role an entity plays in a securitisation transaction. It helps users understand whether an entity is providing the assets, structuring the vehicle, or investing in the issued securities.
+
+```bash
+├── investor
+├── originator
+├── sponsor
+```
+
+### investor
+An entity that holds a position in (i.e., has purchased securities issued by) the securitisation transaction.
+
+### originator
+The entity that either (a) created the original lending agreements giving rise to the exposures being securitised, or (b) purchased exposures from a third party for its own account and then securitises them.
+
+
+### sponsor
+A credit institution or investment firm (other than an originator) that establishes and manages a securitisation programme (such as ABCP) that purchases exposures from third-party entities. The sponsor may delegate day-to-day portfolio management to an authorised entity.
+
+
diff --git a/schemas/loan.json b/schemas/loan.json
index 403b1861..ba0ff226 100644
--- a/schemas/loan.json
+++ b/schemas/loan.json
@@ -703,6 +703,15 @@
       "description": "The name of the reporting legal entity for display purposes.",
       "type": "string"
     },
+    "reporting_entity_role": {
+      "description": "The role played by the entity in the securitisation transaction (originator, sponsor, or investor)",
+      "type": "string",
+      "enum": [
+        "investor",
+        "originator",
+        "sponsor"
+      ]
+    },
     "reporting_id": {
       "description": "The internal ID for the legal entity under which the account is being reported.",
       "type": "string"
diff --git a/v1-dev/loan.json b/v1-dev/loan.json
index b721c4df..a92f1d59 100644
--- a/v1-dev/loan.json
+++ b/v1-dev/loan.json
@@ -691,6 +691,15 @@
       "description": "The name of the reporting legal entity for display purposes.",
       "type": "string"
     },
+    "reporting_entity_role": {
+      "description": "The role played by the entity in the securitisation transaction (originator, sponsor, or investor)",
+      "type": "string",
+      "enum": [
+        "investor",
+        "originator",
+        "sponsor"
+      ]
+    }
     "reporting_id": {
       "description": "The internal ID for the legal entity under which the account is being reported.",
       "type": "string"