Family Tree

regulatory-approvalsAvailable on FreeNo success wrapper

Returns an organization's corporate family tree: the resolved root organization plus its ancestors and descendants up to the requested depth. Call it to trace parent companies and subsidiaries of a regulatory organization. Returns 404 if the key cannot be resolved to an organization, and 400 for invalid query parameters.

When to use it

Trace parent companies of an organization
List subsidiaries and descendants of an organization
Map a corporate ownership hierarchy

Getting started

Base URL

https://app.caelrith.com/api/v1/tools

Authentication

Include your API key in the x-api-key header.

Rate limit

Every call counts against your workspace’s daily quota for regulatoryApiCallsPerDay. Exceeding it returns HTTP 429.

Plans and daily limits

Plan	Available	Calls / day
free	yes	30
pro	yes	200
custom (default)	yes	10,000

Plan defaults. A custom workspace may carry per-tenant overrides.

Parameters

Path parameters

Parameter	Type	Required	Description
key(path)	string	Yes

Query parameters

Parameter	Type	Required	Description
depth	integer	No	Range 1-8; default 3 (range 1-8; default 3) Range: 1 to 8

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/regulatory/organizations/{key}/family-tree"

Response envelope

This endpoint returns an implicit 2xx response - there is no success flag in the body.

{
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

// No "success" flag on this endpoint - any 2xx JSON is a success.

Catalog version mcp-2026-10-28 · generated from the live MCP catalog