Company Hierarchy

Endpoint: `POST /businesses/company_hierarchies/enrich`

Description

The Company Hierarchies Enrichment endpoint provides a structured view of a company's corporate hierarchy, including its parent company, ultimate parent entity, and any known subsidiaries. This proprietary enrichment, developed by Explorium AI, enables users to explore the broader organizational structure a company belongs to — supporting smarter prospect targeting, whitespace discovery, and coordinated expansion strategies across related entities.

In addition to delivering a full JSON representation of the organization tree (anchored by a unique ultimate parent ID), the enrichment provides structured relationship signals describing connections between entities, such as immediate parents and subsidiaries. This offers both a comprehensive and queryable view of corporate relationships.

By surfacing these connections, the enrichment helps to:

Identify opportunities to grow within enterprise groups.
Tailor engagement by specific business units.
Coordinate account strategies across entities under shared ownership.

How It Works

Input: Provide a business_id obtained from the Match Businesses API.
Processing: The system retrieves all known relationships in the corporate hierarchy from multiple verified datasets.
Output: A structured JSON and set of signals detailing immediate parent companies, ultimate parents, and subsidiaries, as well as a full organization tree view.

Example Request (cURL)

curl -X 'POST' \
  'https://api.explorium.ai/v1/businesses/company_hierarchies/enrich' \
  -H 'accept: application/json' \
  -H 'api_key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "request_context": {},
  "business_id": "f21530ca2ee13d38c434cff9f6f56726"
}'

Example Response

  "data": {
  "business_id": "f21530ca2ee13d38c434cff9f6f56726",
  "parent_company_id": "e11943a6031a0e6114ae69c257617980",
  "parent_company_name": "pepsico",
  "ultimate_parent_id": "e11943a6031a0e6114ae69c257617980",
  "ultimate_parent_name": "pepsico",
  "subsidiaries": [
    {
      "id": "57e40bf2ab85ec3c8368dbe8b57830f7",
      "name": "soda club worldwide bv"
    },
    {
      "id": "9d0b83a3cbbba4406a24caae8e3bbadc",
      "name": "opm"
    }
  ],
  "organization_tree": {
    "level": "companies"
  }
},
"entity_id": "f21530ca2ee13d38c434cff9f6f56726"
}

Best Practices

Always obtain thebusiness_id via the Match Businesses API before making company hierarchy enrichment requests.
Leverage relationship data to identify new business opportunities across connected entities.
Cross-reference with other enrichment APIs (e.g., Firmographics, Technographics) for deeper business context.
Incorporate hierarchy analysis into account planning for better coordination across business units.

Company Hierarchies Output Signals

Signal	API Name	Description	Data Type
Input company ID	input_company_id	The original `business_id` provided as input.	EXPLORIUM_ID
Input company name	input_company_name	The name of the input company.	COMPANY
Parent company ID	parent_company_id	Business ID of the immediate parent company.	EXPLORIUM_ID
Parent company name	parent_company	The name of the immediate parent company.	COMPANY
Ultimate parent ID	ultimate_parent_id	Business ID of the top-most company in the hierarchy (level_0).	EXPLORIUM_ID
Ultimate parent name	ultimate_parent_name	The name of the top-most company in the hierarchy (level_0).	COMPANY
Subsidiaries	subsidiaries	List of direct subsidiaries.	JSON
Organization hierarchy tree	org_tree_json	A JSON structure representing the full organizational tree from top to bottom.	JSON

📌 For additional enrichment options, explore related API endpoints below.

Endpoint: POST /businesses/company_hierarchies/enrich

Description

Endpoint: `POST /businesses/company_hierarchies/enrich`