CorporateStructure

Corporate group structure

  • hierarchy
    Type: array object[] · StructureNode[]

    Flat list of every entity in the corporate group. Each node carries the ids of its direct children, so the tree can be reconstructed from this list. Null when no group hierarchy is available.

    A company within the corporate group

    • children
      Type: array string[]

      Ids of this node's direct subsidiaries, referencing other nodes' id values. Null or empty for a leaf node.

    • dissolved
      Type: boolean

      True when this group member is in a terminal state (dissolved, removed, closed or converted-closed) and therefore no longer live. Null when unknown.

    • id
      Type: string

      Opaque identifier for this node within the group. Referenced by other nodes' children arrays so the flat list can be assembled into a tree.

    • jurisdiction
      Type: string

      Jurisdiction of incorporation of this group member, as an ISO 3166-1 alpha-2 country code. Null when unknown.

    • name
      Type: string

      Registered legal name of this group member.

    • registrationNumber
      Type: string

      Company registration number of this group member.

    • status
      Type: string

      Human-readable trading-status label for this group member (a display string, not a stable code). Typical values include Actively trading, Inactive, Strike-off process initiated, In administration, In liquidation, Overseas entity, Dissolved, Converted closed, Removed and Closed overseas entity. Null when the status is unknown.

  • immediateParent
    Type: object

    The company's immediate (direct) parent company. Null when the company has no known direct parent or is itself the group head.

    • children
      Type: array string[]

      Ids of this node's direct subsidiaries, referencing other nodes' id values. Null or empty for a leaf node.

    • dissolved
      Type: boolean

      True when this group member is in a terminal state (dissolved, removed, closed or converted-closed) and therefore no longer live. Null when unknown.

    • id
      Type: string

      Opaque identifier for this node within the group. Referenced by other nodes' children arrays so the flat list can be assembled into a tree.

    • jurisdiction
      Type: string

      Jurisdiction of incorporation of this group member, as an ISO 3166-1 alpha-2 country code. Null when unknown.

    • name
      Type: string

      Registered legal name of this group member.

    • registrationNumber
      Type: string

      Company registration number of this group member.

    • status
      Type: string

      Human-readable trading-status label for this group member (a display string, not a stable code). Typical values include Actively trading, Inactive, Strike-off process initiated, In administration, In liquidation, Overseas entity, Dissolved, Converted closed, Removed and Closed overseas entity. Null when the status is unknown.

  • ownershipStatus
    Type: string enum

    Whether the company is wholly or partially owned within its group. Null when the ownership status is not known. One of:

    • WHOLLY_OWNED — the company is wholly owned within the group.
    • PARTIALLY_OWNED — the company is only partially owned within the group.
    values
    • WHOLLY_OWNED
    • PARTIALLY_OWNED
  • ultimateParent
    Type: object

    The ultimate parent at the head of the corporate group (the entity not owned by any other entity in the hierarchy). Null when the company is not part of a known group or the group head cannot be determined.

    • children
      Type: array string[]

      Ids of this node's direct subsidiaries, referencing other nodes' id values. Null or empty for a leaf node.

    • dissolved
      Type: boolean

      True when this group member is in a terminal state (dissolved, removed, closed or converted-closed) and therefore no longer live. Null when unknown.

    • id
      Type: string

      Opaque identifier for this node within the group. Referenced by other nodes' children arrays so the flat list can be assembled into a tree.

    • jurisdiction
      Type: string

      Jurisdiction of incorporation of this group member, as an ISO 3166-1 alpha-2 country code. Null when unknown.

    • name
      Type: string

      Registered legal name of this group member.

    • registrationNumber
      Type: string

      Company registration number of this group member.

    • status
      Type: string

      Human-readable trading-status label for this group member (a display string, not a stable code). Typical values include Actively trading, Inactive, Strike-off process initiated, In administration, In liquidation, Overseas entity, Dissolved, Converted closed, Removed and Closed overseas entity. Null when the status is unknown.

Grand Public API