{"components":{"schemas":{"BadRequest":{"description":"Returned when something is wrong in the request, e.g. failed argument validation or missed argument","properties":{"attributes":{"description":"Invalid attributes","items":{"$ref":"#/components/schemas/RequestAttribute"},"type":"array"},"error":{"default":"BadRequest","description":"Error name","type":"string"},"message":{"default":"Required arguments are missing in the request","description":"Description of the request error","type":"string"}},"type":"object"},"CompanyGroupStructureResults":{"description":"Roaring Group company groupStructure results","properties":{"records":{"description":"found groupStructure results","items":{"$ref":"#/components/schemas/GroupStructure"},"type":"array"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"type":"object"},"GroupCompany":{"properties":{"companyId":{"description":"Company identifier of group member","type":"string"},"companyLevel":{"description":"Group member level in group structure tree.","format":"int32","type":"integer"},"companyName":{"description":"Name of group member","type":"string"},"countryCode":{"description":"Country of group member","type":"string"},"motherCompanyId":{"description":"Company identifier of closest mother","type":"string"},"nodeId":{"description":"Company node identifier","format":"int32","type":"integer"},"ownedPercentages":{"$ref":"#/components/schemas/OwnedPercentages"},"parentNodeId":{"description":"Parent company node identifier","format":"int32","type":"integer"},"relationshipType":{"description":"Type of relationship","enum":["Dependent"," Associate"," Multigroup"," Does not inform"],"type":"string"}},"type":"object"},"GroupStructure":{"properties":{"changeDate":{"description":"Latest change date (Date in ISO 8601 standard)","type":"string"},"companyId":{"description":"Group mother company identifier (NIF)","type":"string"},"companyName":{"description":"Company name of group mother","type":"string"},"countryCode":{"description":"Country of group mother","type":"string"},"groupCompanies":{"description":"List of group companies","items":{"$ref":"#/components/schemas/GroupCompany"},"type":"array"},"nodeId":{"description":"Company node identifier","format":"int32","type":"integer"}},"type":"object"},"OwnedPercentages":{"properties":{"ownedPercentageDirect":{"description":"Direct ownership by the closest mother, percentage","format":"double","type":"number"},"ownedPercentageIndirect":{"description":"Indirect ownership by the closest mother, percentage","format":"double","type":"number"},"ownedPercentageTotal":{"description":"Total ownership by the closest mother, percentage","format":"double","type":"number"}},"type":"object"},"RequestAttribute":{"description":"Incorrect attribute of request","properties":{"attribute":{"description":"Parameter name","type":"string"},"value":{"description":"Parameter value, subject for validation","type":"string"}},"type":"object"},"SearchResultStatus":{"description":"Description of search result","properties":{"code":{"description":"0 - found, 1 - not found","format":"int32","type":"integer"},"text":{"description":"search result description","type":"string"}},"type":"object"},"ServerError":{"description":"Internal server error","properties":{"error":{"default":"InternalServerError","description":"Error name","type":"string"},"message":{"default":"An internal server error occurred, please contact the system administrator with information on the error","description":"Description of the request error","type":"string"}},"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://api.roaring.io/token"}},"type":"oauth2"}}},"info":{"description":"Group structure of the company\nAccess Ownership and Affiliation Insights with the Group Structure API\nThe Group Structure API provides valuable data on a company’s ownership chains and affiliations, revealing ultimate control and ownership across a group. This data helps organisations assess risks from related entities, ensure regulatory compliance, and detect conflicts of interest, strengthening risk evaluation and decision-making.\n\nWith this API, you can:\n- View the entire company group structure, including parent companies and subsidiaries\n- See ownership percentages and relationships between companies in the group in a “tree” formation\n- Monitor changes to a company’s group structure over time with webhooks, receiving notifications of any updates\n\n**Use case:**\n\nA corporate governance team uses the Group Structure API to map out the ownership and affiliations of a potential business partner, ensuring there are no hidden conflicts of interest or regulatory concerns before entering into a partnership.\n\n\n\n\n\n\n\n","title":"Company Group Structure","version":"1.0","x-logo":{"url":"https://assets.roaring.io/svg/org-structure-v3.1.svg"}},"openapi":"3.0.1","paths":{"/{companyId}":{"get":{"description":"AsOfDate supported\n\n### Sandbox examples\nIn order to test the service, please use the following values in the Sandbox environment:\n\n| Description | URL |\n| - | - |\n| No group structure exists | [/es/company/group-structure/1.0/A00000067](#L2VzL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC9BMDAwMDAwNjc=) |\n| Group with foreign associated companies | [/es/company/group-structure/1.0/A00000059](#L2VzL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC9BMDAwMDAwNTk=) |\n| Company with one dependent company | [/es/company/group-structure/1.0/B00000018](#L2VzL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC9CMDAwMDAwMTg=) |\n","operationId":"view","parameters":[{"description":"id of company","in":"path","name":"companyId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyGroupStructureResults"}}},"description":"OK, successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}},"description":"Returned when something is wrong in the request, e.g. failed argument validation or arguments are missing"},"404":{"description":"Requested resource could not be found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}},"description":"An internal server error occurred, please contact the system administrator with information on the error"}},"summary":"Find group structure by company id","tags":["GroupStructureEs"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/es/company/group-structure/1.0/{companyId}'"}]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/es/company/group-structure/1.0"}],"x-category":"company","x-countries":["es"],"x-id":"GroupStructureEs"}