{"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 Apps company Group Structure results","properties":{"records":{"description":"found Group Structure results","items":{"$ref":"#/components/schemas/GroupStructure"},"type":"array"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"type":"object"},"GroupCompany":{"properties":{"companyId":{"description":"Company identifier (company registration number / organization number) of group member","type":"string"},"companyLevel":{"description":"Group member level in group structure tree.","format":"int32","type":"integer"},"companyName":{"description":"Company name of group member","type":"string"},"countryCode":{"description":"Country code of group member","type":"string"},"motherCompanyId":{"description":"Company identifier (company registration number / organization number) of closest mother","type":"string"},"ownedPercentageInterval":{"description":"Percentage interval","format":"double","type":"number"},"ownedVotePercentageInterval":{"description":"Vote percentage interval","format":"double","type":"number"}},"type":"object"},"GroupStructure":{"properties":{"changeDate":{"description":"Date for the latest change (Date in ISO 8601 standard)","type":"string"},"companyId":{"description":"Company identifier (company registration number / organization number)","type":"string"},"companyName":{"description":"Name of group mother company","type":"string"},"countryCode":{"description":"Country code of group mother company","type":"string"},"groupCompanies":{"description":"List of group companies","items":{"$ref":"#/components/schemas/GroupCompany"},"type":"array"}},"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| Value | Interval | \n| --- | --- |\n0.6667 | 66.67-89.99%\n0.67 | 66.67-89.99%\n0.9 | 90.00-99.99%\n1 | 100%\n\n**Corresponding intervals for ownedVotePercentageInterval values:**\n\n| Value | Interval | \n| --- | --- |\n0 | 0-5%\n0.05 | 5-10%\n0.1 | 10-15% \n0.15 | 15-20%\n0.2 | 20-25%\n0.25 | 25-33%\n0.3333 | 33-50%\n0.5 | 50-66.67%\n0.6667 | 66.67-89.99%\n0.67 | 66.67-89.99%\n0.9 | 90.00-99.99%\n1 | 100%\n\n","title":"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| Company A | [/dk/company/group-structure/1.0/41773863](#L2RrL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC80MTc3Mzg2Mw==) |\n|  | [/dk/company/group-structure/1.0/12345674](#L2RrL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC8xMjM0NTY3NA==) |\n|  | [/dk/company/group-structure/1.0/23456788](#L2RrL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC8yMzQ1Njc4OA==) |\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, successfull 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":"Fetch company group structure","tags":["GroupStructureDk"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/dk/company/group-structure/1.0/{companyId}'"}]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/dk/company/group-structure/1.0"}],"x-category":"company","x-countries":["dk"],"x-id":"GroupStructureApiDk"}