---
title: "Get Subsidiaries"
method: POST
path: "/v1/knowledge-graph/subsidiaries/query"
tags: ["Companies"]
---

# Get Subsidiaries

`POST /v1/knowledge-graph/subsidiaries/query`

Returns the full subsidiary hierarchy for a given company. For each subsidiary includes: ultimate parent, immediate parent, company name, and hierarchy depth level.

## Request body

- GetCompanySubsidiariesRequest — Request body for retrieving the subsidiary hierarchy of a company
  - `identifier` object, required — Object specifying which identifier you are using to request the data. You must supply one type and its corresponding value.
    - `type` 'rp_entity_id', required — Object specifying which identifier you are using to request the company subsidiaries. You must supply one type and its corresponding value.
    - `value` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Apple Inc. (D8442A)

## Response `200`

Successful response with subsidiary hierarchy

- GetCompanySubsidiariesResponse — Response containing the subsidiary hierarchy for a given company
  - `results` SubsidiaryRecord[], required — List of subsidiaries in the corporate hierarchy
    - `ultimate_parent_id` string, nullable — Entity ID of the ultimate parent, the topmost entity in the corporate tree, typically the holding company that directly or indirectly owns more than 50% stake in the subsidiaries below it
    - `ultimate_parent_name` string, nullable — Name of the ultimate parent company at the top of the corporate hierarchy
    - `immediate_parent_id` string, nullable — Entity ID of the immediate parent, the direct owner of this subsidiary, holding a 50% or greater stake in it
    - `immediate_parent_name` string, nullable — Name of the immediate parent company that directly owns this subsidiary
    - `identifier` string, required — Entity ID of the subsidiary whose position in the corporate ownership structure is being described
    - `entity_name` string, nullable — Name of the subsidiary entity identified by the identifier field
    - `level` integer, required — Depth in the corporate hierarchy relative to the ultimate parent (level 1 = the ultimate parent itself, level 2 = direct subsidiary, level 3 = grandchild subsidiary, and so on). Results only include level 2 and deeper.
  - `errors` unknown[] — List of errors if any occurred
    - unknown
  - `metadata` object, required
    - `request_id` string, required — Unique request identifier
    - `timestamp` string — ISO 8601 timestamp of when the response was generated
    - `rp_entity_id` string, required — The queried entity ID

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)