diff --git a/docs/api/README.md b/docs/api/README.md
index 1ee7c6158..0b019b188 100644
--- a/docs/api/README.md
+++ b/docs/api/README.md
@@ -167,6 +167,7 @@ However, if the provided data is too few or of too bad quality the business part
 Querying the sharing state of the business partner will reveal the current state in the golden record process.
 Here, the sharing member can also see whether and why the business partner has been rejected.
 
+
 #### Sharing a Business Partner With Site Information
 
 Postman collection request ID: S.CPS
@@ -254,6 +255,444 @@ Likewise, if a legal entity parent has to be created for a site the legal addres
 
 - Confidence Criteria: The dummy golden record service fills all confidence criteria with static dummy values.
 
+
+#### High-Level Input Output Examples
+
+```mermaid
+---
+title: Share Unknown Business Partner Data
+---
+classDiagram
+  direction LR
+  class Input{
+    ExternalId: Own-ID
+    Name Parts: [Company AG, Main Office]
+    Physical Country: DE
+    Physical City: Berlin
+    Physical Postcode: 12435
+    Street Name: Main Street
+    Street Number: 123
+  }
+
+  class Output{
+    ExternalId: Own-ID
+    Legal Entity Bpn: BPNL000000000001
+    Address Bpn: BPNA000000000001
+    Name Parts: [Company AG, Main Office]
+    Legal Name: Company AG Main Office
+    Address Type: Legal Address
+    Physical Country: DE
+    Physical City: Berlin
+    Physical Postcode: 12435
+    Street Name: Main Street
+    Street Number: 123
+    Legal Entity Confidence: ...
+    Site Confidence: ...
+    Address Confidence: ...
+  }
+
+  Input --> Output
+```
+
+```mermaid
+---
+title: Share Legal Entity
+---
+classDiagram
+  direction LR
+    class Input{
+         ExternalId: Own-ID
+         Legal Name: Company AG
+         Address Type: Legal Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+    }
+   
+   class Output{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Address Bpn: BPNA000000000001
+         Legal Name: Company AG
+         Address Type: Legal Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         Legal Entity Confidence: ...
+         Address Confidence: ...
+   }
+
+    Input --> Output
+```
+
+```mermaid
+---
+title: Share Site
+---
+classDiagram
+  direction LR
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Site Name: Main Site
+         Address Type: Site Main Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         IsOwnCompanyData: true
+    }
+   
+   class Output{
+         ExternalId: Own-ID
+         Legal Name: Company AG
+         Legal Entity Bpn: BPNL000000000001
+         Site Bpn: BPNS000000000001
+         Address Bpn: BPNA000000000001
+         Address Type: Site Main Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         Legal Entity Confidence: ...
+         Site Confidence: ...
+         Address Confidence: ...
+         IsOwnCompanyData: true
+   }
+
+    Input --> Output
+``` 
+```mermaid
+---
+title: Share Additional Address of Legal Entity
+---
+classDiagram
+  direction LR
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+    }
+   
+   class Output{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Address Bpn: BPNA000000000001
+         Legal Name: Company AG
+         Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         Legal Entity Confidence: ...
+         Address Confidence: ...
+   }
+
+    Input --> Output
+```
+
+```mermaid
+---
+title: Share Additional Address of Site
+---
+classDiagram
+  direction LR
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Site Bpn: BPNS000000000001
+         Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         IsOwnCompanyData: true
+    }
+   
+   class Output{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Site Bpn: BPNS000000000001
+         Address Bpn: BPNA000000000001
+         Legal Name: Company AG
+         Site Name: Main Site
+        Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         Legal Entity Confidence: ...
+         Site Confidence: ...
+         Address Confidence: ...
+         IsOwnCompanyData: true
+   }
+
+    Input --> Output
+```
+
+#### High Level Golden Record Examples
+
+```mermaid
+---
+title: Share Unknown Business Partner
+---
+classDiagram
+ direction LR
+
+    class Input{
+        ExternalId: Own-ID
+        Name Parts: [Company AG, Main Office]
+        Physical Country: DE
+        Physical City: Berlin
+        Physical Postcode: 12435
+        Street Name: Main Street
+        Street Number: 123
+    }
+   
+    class LegalEntity["Legal Entity"]{
+        BPNL: BPNL000000000001
+        Legal Name: Company AG Main Office
+        Legal Address Physical Country: DE
+        Legal Address Physical City: Berlin
+        Legal Address Physical Postcode: 12435
+        Legal Address Street Name: Main Street
+        Legal Address Street Number: 123
+        Legal Entity Confidence: ...
+        Legal Address Confidence: ...
+    }
+
+    Input --> LegalEntity
+```
+
+```mermaid
+---
+title: Share Legal Entity
+---
+classDiagram
+ direction LR
+
+    class Input{
+         ExternalId: Own-ID
+         Legal Name: Company AG
+         Address Type: Legal Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+    }
+   
+    class LegalEntity["Legal Entity"]{
+        BPNL: BPNL000000000001
+        Legal Name: Company AG Main Office
+        Legal Address Physical Country: DE
+        Legal Address Physical City: Berlin
+        Legal Address Physical Postcode: 12435
+        Legal Address Street Name: Main Street
+        Legal Address Street Number: 123
+        Legal Entity Confidence: ...
+        Legal Address Confidence: ...
+    }
+
+    Input --> LegalEntity
+```
+
+```mermaid
+---
+title: Share Site
+---
+classDiagram
+ direction LR
+
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Site Name: Main Site
+         Address Type: Site Main Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+         IsOwnCompanyData: true
+    }
+   
+    class Site{
+        BPNS: BPNS000000000001
+        Site Name: Main Site
+        Main Address Physical Country: DE
+        Main Address Physical City: Berlin
+        Main Address Physical Postcode: 12435
+        Main Address Street Name: Main Street
+        Main Address Street Number: 123
+        Site Confidence: ...
+        Main Address Confidence: ...
+    }
+
+    class LegalEntity["Legal Entity"]{
+        BPNL: BPNL000000000001
+    }
+
+    Input --> Site
+    Site --> LegalEntity: belongs to
+```
+
+
+```mermaid
+---
+title: Share Additional Address Of Site
+---
+classDiagram
+  direction LR
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Site Bpn: BPNS000000000001
+         Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+    }
+   
+    class AdditionalAddress["Additional Address"]{
+        BPNA: BPNA000000000001
+        Name: Gate 1
+        Physical Country: DE
+        Physical City: Berlin
+        Physical Postcode: 12435
+        Street Name: Main Street
+        Street Number: 123
+        Confidence: ...
+    }
+
+    class LegalEntity["Legal Entity"]{
+        BPNL: BPNL000000000001
+    }
+
+    class Site{
+        BPNS: BPNS000000000001
+    }
+
+    Input --> AdditionalAddress
+    AdditionalAddress --> Site: belongs to
+    Site --> LegalEntity: belongs to
+```
+
+```mermaid
+---
+title: Share Additional Address Of Legal Entity
+---
+classDiagram
+ direction LR
+
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Bpn: BPNL000000000001
+         Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+    }
+   
+    class AdditionalAddress["Additional Address"]{
+        BPNA: BPNA000000000001
+        Name: Gate 1
+        Physical Country: DE
+        Physical City: Berlin
+        Physical Postcode: 12435
+        Street Name: Main Street
+        Street Number: 123
+        Confidence: ...
+    }
+
+    class LegalEntity["Legal Entity"]{
+        BPNL: BPNL000000000001
+    }
+
+    Input --> AdditionalAddress
+    AdditionalAddress --> LegalEntity: belongs to
+```
+
+```mermaid
+classDiagram
+  direction LR
+    class Input{
+         ExternalId: Own-ID
+         Legal Entity Name: Company AG
+         Site Name: Main Site
+         Address Name: Gate 1
+         Address Type: Additional Address
+         Physical Country: DE
+         Physical City: Berlin
+         Physical Postcode: 12435
+         Street Name: Main Street
+         Street Number: 123
+    }
+   
+    class AdditionalAddress["Additional Address"]{
+        BPNA: BPNA000000000001
+        Name: Gate 1
+        Physical Country: DE
+        Physical City: Berlin
+        Physical Postcode: 12435
+        Street Name: Main Street
+        Street Number: 123
+        Confidence: ...
+    }
+
+    class LegalEntity["Legal Entity"]{
+        BPNL: BPNL000000000001
+        Legal Name: Company AG Main Office
+        Legal Address Physical Country: DE
+        Legal Address Physical City: Berlin
+        Legal Address Physical Postcode: 12435
+        Legal Address Street Name: Main Street
+        Legal Address Street Number: 123
+        Legal Entity Confidence: ...
+        Legal Address Confidence: ...
+    }
+
+    class Site{
+        BPNS: BPNS000000000001
+        Site Name: Main Site
+        Main Address Physical Country: DE
+        Main Address Physical City: Berlin
+        Main Address Physical Postcode: 12435
+        Main Address Street Name: Main Street
+        Main Address Street Number: 123
+        Site Confidence: ...
+        Main Address Confidence: ...
+    }
+
+    Input --> AdditionalAddress
+    AdditionalAddress --> Site: belongs to
+    Site --> LegalEntity: belongs to
+```
+
 ## Orchestrator API
 
 This API offers endpoints for retrieving and resolving business partner data being processed inside the golden record process.