{"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"},"ownedPercentage":{"description":"Percentage of ownership by the closest mother","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"},"latestChangeDate":{"description":"Date for the latest change of company in group (Date in ISO 8601 standard)","type":"string"}},"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","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| AS: Limited company, Aksjeselskap | [/no/company/group-structure/1.0/987191961](#L25vL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC85ODcxOTE5NjE=) |\n| AS: Limited company, Aksjeselskap | [/no/company/group-structure/1.0/810392312](#L25vL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC84MTAzOTIzMTI=) |\n| Company V | [/no/company/group-structure/1.0/914938589](#L25vL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC85MTQ5Mzg1ODk=) |\n| Company X | [/no/company/group-structure/1.0/913589505](#L25vL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC85MTM1ODk1MDU=) |\n| Group structure AS: Limited company, aksjeselskap | [/no/company/group-structure/1.0/793969015](#L25vL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC83OTM5NjkwMTU=) |\n| AS limited company no group structure Company Z | [/no/company/group-structure/1.0/989781707](#L25vL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC85ODk3ODE3MDc=) |\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":["GroupStructureNo"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/no/company/group-structure/1.0/{companyId}'"}]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/no/company/group-structure/1.0"}],"x-category":"company","x-countries":["no"],"x-id":"GroupStructureApiNo"}