institution_structure

Get NIC institution ownership relationships or merger transformations.

Examples

from openbb import obb
# Get holding-company ownership relationships for an institution.
obb.federal_reserve.ffiec.institution_structure(rssd_id='1039502', provider='federal_reserve')
# Get merger/acquisition transformations.
obb.federal_reserve.ffiec.institution_structure(kind='transformations', rssd_id='1039502', provider='federal_reserve')

Parameters

• standard
• federal_reserve

kind: str | None
Default: relationships
Hierarchy ownership 'relationships' or merger/acquisition 'transformations'.

rssd_id: str | None
Filter to records referencing this RSSD identifier.

---

Returns

results: FederalReserveInstitutionStructure

Serializable results.

provider: str | None

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• federal_reserve

offspring_name: str | None
The name of the offspring (owned/controlled subsidiary).

parent_name: str | None
The name of the parent (owner/controller).

successor_name: str | None
The name of the successor (survivor).

predecessor_name: str | None
The name of the predecessor (non-survivor).

relationship_level: str | None
Whether the relationship is direct or indirect.

control_indicator: str | None
Whether the parent controls the offspring.

equity_indicator: str | None
The form of ownership or control.

percent_equity: float | None
The parent's percent of equity voting control.

percent_other: float | None
The parent's percent of other voting control.

percent_equity_bracket: str | None
The bracketed range of the equity percent.

regulated_indicator: str | None
Whether the relationship is regulated.

reason_relationship_terminated: str | None
The reason the relationship was terminated.

transformation_type: str | None
The type of merger/acquisition transformation.

accounting_method: str | None
The accounting method used in the transformation.

relationship_established_date: date | None
The date the relationship was established.

start_date: date | None | str
The date the record became effective.

end_date: date | None | str
The date the record ceased to be valid.

transformation_date: date | None
The date the transformation became effective.

offspring_rssd_id: str | None
The RSSD identifier of the offspring (owned/controlled).

parent_rssd_id: str | None
The RSSD identifier of the parent (owner/controller).

successor_rssd_id: str | None
The RSSD identifier of the successor (survivor).

predecessor_rssd_id: str | None
The RSSD identifier of the predecessor (non-survivor).