/api/v1/regulatory/organizations/:key/subsidiary-approvalsSubsidiary Approvals
Returns a paginated list of regulatory approvals linked to an organization and its subsidiaries, with metadata including total counts and the organization keys covered. Call it to see approvals across an organization's subsidiary structure, optionally including parent organizations. Returns 400 for invalid query parameters or when the requested organization data is not available, and 500 on internal failure.
When to use it
- List approvals across an organization and its subsidiaries
- Review subsidiary approvals for a parent company
- Page through regulatory approvals by organization
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
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 0-8; default 3 (range 0-8; default 3) Range: 0 to 8 |
| include_ancestors | boolean | No | Default false (default false) |
| page | integer | No | Min 1; default 1 (min 1; default 1) Range: 1 to ∞ |
| limit | integer | No | Range 1-5000; default 20 (range 1-5000; default 20) Range: 1 to 5000 |
| sort | string | No | Default approval_date (default approval_date) Allowed values: approval_date, updated |
| order | string | No | Default desc (default desc) Allowed values: asc, desc |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/regulatory/organizations/{key}/subsidiary-approvals"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