How is the Legal Entity Hierarchy request working ?

BTh
BTh Contributor
in DSS

What does one input in the request and what is the return containing ?

Does one enter an OrgID and get data about the whole tree structure containing this OrgID? What's the basic idea behind it? What's the "RCP ID" that seems to be an important field in that request?

Thanks for hints and info.

Bernard

Tagged:

Best Answer

Answers

  • Christiaan Meihsl
    Christiaan Meihsl LSEG

    @BTh,

    The legal entity hierarchy allows you to see companies, who belong to them (subsidiaries), who they belong to (parents), and affiliates.

    Here is an example body of the request using the API, using a RIC as the instrument identifier. I used the instrument 0700.HK which is Tencent Holdings, on the Hong Kong exchange:

    {
      "ExtractionRequest": {
        "@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.LegalEntityHierarchyExtractionRequest",
        "ContentFieldNames": [
          "Node/Level", "Official Name", "Relationship Type",
          "Derived Parent Official Name", "Derived Ultimate Parent Official Name",
          "Immediate Parent Official Name", "Ultimate Parent Official Name",
          "Related Official Name"
        ],
        "IdentifierList": {
          "@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.EntityIdentifierList", 
          "EntityIdentifiers": [ { "Identifier": "0700.HK", "IdentifierType": "Ric" } ]
        },
        "Condition": { "DeltaDays": -1 }
      }
    }

    The "DeltaDays": -1 condition means that we want all the historical data. If you only wanted the changes of the last N days, let us say the last week, you could set "DeltaDays": 7.

    You can make the same request in the GUI, by searching for the instrument, then clicking on it. Then click in the left column menu on Legal Entity, then on More Entity Details, and finally on Hierarchy, which will take you here:

    image

    I don't see any RCP ID in the request parameters. Can you tell me where you found it ?

  • Christiaan Meihsl
    Christiaan Meihsl LSEG
    https://community.developers.refinitiv.com/discussion/comment/35525#Comment_35525

    See also this query, on the same topic.

  • BTh
    BTh Contributor

    The RCP ID is a field mentioned in the DSS.Api.examples app for the LegalEntityHierarchy request:

    ContentFieldNames = new[] {


    "ID", "ID Type", "Immediate Parent ID", "Immediate Parent Official Name",


    "Immediate Parent RCP ID", "Node/Level", "Official Name", "RCP ID",


    "Source RCP ID", "Ultimate Parent ID", "Ultimate Parent Official Name", "Ultimate Parent RCP ID",


    "User Defined Identifier"}

    In your answer to the former query last November, you mention the "first element" of the response. Does that mean that basically this request returns all entities below the input entity, i.e. it should be used for the hierarchy "head" and delivers all the entities linked to this head ?

    Bernard

Categories