Skip to main content
GET
/
v2
/
companies
/
{companyNumber}
/
group-structure
Get company group structure
curl --request GET \
  --url https://product-api.thedatacity.com/api/v2/companies/{companyNumber}/group-structure \
  --header 'Authorization: Bearer <token>'
[
  {
    "CanBeConsolidated": true,
    "ConsolidatedAccountsCompanyName": "<string>",
    "ConsolidatedAccountsCompanyNumber": "<string>",
    "IsLikelyDistinctBrand": true,
    "IsSubGroup": true,
    "ParentCompanyName": "<string>",
    "ParentCompanyNumber": "<string>",
    "SubsidiaryCompanyLevel": 123,
    "SubsidiaryCompanyName": "<string>",
    "SubsidiaryCompanyNumber": "<string>",
    "SubsidiaryCompanyWebsite": "<string>",
    "TypeOfAccounts": "<string>",
    "UltimateParentCompanyName": "<string>",
    "UltimateParentCompanyNumber": "<string>"
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

companyNumber
string
required

Companies House company number.

Response

200 - application/json

Group structure rows from the product API (data dictionary GroupStructureDetails).

CanBeConsolidated
boolean

Indicates whether the subsidiary company can be consolidated into the parent company's financial statements.

ConsolidatedAccountsCompanyName
string

The name of the company whose accounts are consolidated with the subsidiary. There can be multiple consolidated accounts company names if the subsidiary's accounts are consolidated with more than one other company.

ConsolidatedAccountsCompanyNumber
string

The Company Number of the company whose accounts are consolidated with the subsidiary. There can be multiple consolidated accounts company numbers if the subsidiary's accounts are consolidated with more than one other company.

IsLikelyDistinctBrand
boolean

Indicates whether the subsidiary is likely to be a distinct brand within the parent company's group structure.

IsSubGroup
boolean

Indicates whether the subsidiary is part of a sub-group within the parent company's group structure.

ParentCompanyName
string

The name of the parent company directly above the subsidiary in the group structure.

ParentCompanyNumber
string

The Company Number of the parent company directly above the subsidiary in the group structure.

SubsidiaryCompanyLevel
integer<int32>

The level at which the subsidiary company operates within the group structure. Level 0 is the ultimate parent company.

SubsidiaryCompanyName
string

The name of the subsidiary company.

SubsidiaryCompanyNumber
string

The Company Number of the subsidiary.

SubsidiaryCompanyWebsite
string

The website of the subsidiary company.

TypeOfAccounts
string

The type of accounts filed by the subsidiary company, which can indicate its financial reporting requirements and potential consolidation status.

UltimateParentCompanyName
string

The name of the ultimate parent company in the group structure.

UltimateParentCompanyNumber
string

The Company Number of the ultimate parent company in the group structure.

Last modified on June 8, 2026