{"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"},"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"},"GroupStructureWrapper":{"properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"countryCode":{"type":"string"},"groupCompanies":{"items":{"$ref":"#/components/schemas/GroupCompany"},"type":"array"},"hitCount":{"format":"int32","type":"integer"},"latestChangeDate":{"type":"string"},"responseInfo":{"$ref":"#/components/schemas/ResponseInfo"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"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"},"ResponseInfo":{"properties":{"hitCount":{"format":"int32","type":"integer"},"noMatchIds":{"items":{"type":"string"},"type":"array"},"requestCount":{"format":"int32","type":"integer"}},"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":"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| Group structure limited partnership | [/se/company/group-structure/1.0/9168937861](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC85MTY4OTM3ODYx) |\n| Non profit organization  | [/se/company/group-structure/1.0/8020028638](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC84MDIwMDI4NjM4) |\n| Including foreign companies | [/se/company/group-structure/1.0/5564881422](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC81NTY0ODgxNDIy) |\n| Company with nine affiliates | [/se/company/group-structure/1.0/5564779444](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC81NTY0Nzc5NDQ0) |\n| Wilfast Holding Aktiebolag | [/se/company/group-structure/1.0/5565002465](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC81NTY1MDAyNDY1) |\n| Company with one affiliate  | [/se/company/group-structure/1.0/5567164818](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC81NTY3MTY0ODE4) |\n| Large Group structure | [/se/company/group-structure/1.0/5569994600](#L3NlL2NvbXBhbnkvZ3JvdXAtc3RydWN0dXJlLzEuMC81NTY5OTk0NjAw) |\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/GroupStructureWrapper"}}},"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"},"401":{"description":"Returned when the user is not authenticated"},"403":{"description":"Returned when the user is not authorized to access the resource"},"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":["GroupStructure"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/se/company/group-structure/1.0/{companyId}'"}]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/se/company/group-structure/1.0"}],"x-category":"company","x-countries":["se"],"x-id":"GroupStructure"}