Skip to main content
POST
V2 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.
v2: this endpoint accepts either a single ID (a string) or a list of up to 50 IDs — the separate /bulk_enrich route is gone. See v2 conventions.

​
Enrich by company details instead of IDs

business_ids is the primary way to call this endpoint. If you don’t have Explorium IDs yet, you can send businesses_to_match instead: up to 50 companies, described with the same fields the Match businesses endpoint accepts (name, domain, url, linkedin_url). Each company is matched and enriched in the same call. Send either business_ids or businesses_to_match, never both (that returns a 422). Any parameters the endpoint takes work the same either way.
Each row echoes its input and returns the matched business_id. Companies that don’t match come back with business_id: null and data: null, and aren’t charged. total_matches counts the matched rows.
  • 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.
Bash
JSON
  • 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.
For additional enrichment options, explore related API endpoints below.

Authorizations

​
api_key
string
header
required

Body

application/json

Provide exactly one of business_ids or businesses_to_match; at most 50 entities.

​
business_ids
required
Pattern: ^[a-f0-9]{32}$
​
request_context
Request Context · object | null
Example:

null

​
parameters
Parameters · object | null
​
businesses_to_match
BusinessMatchInput · object[]

Match and enrich up to 50 businesses. Provide this or business_ids, never both.

Required array length: 1 - 50 elements
Example:

Response

Successful Response

This is base response model for all responses in partner service.

​
response_context
V2ResponseContext · object
required
​
data
V2BusinessEnrichRow[CompanyHierarchiesOutputSchema] · object[]
required
​
total_results
integer
required