# Entity Structure Graph API

*/Software/Entity_Structure_Graph_API*

## Solution Overview

The Entity Structure Graph API converts unstructured corporate registry filings, SEC disclosures, and global news feeds into a standardized JSON graph of ultimate beneficial ownership and subsidiary hierarchies. It extracts ownership percentages, board overlaps, and shell-company linkages, outputting a machine-readable dependency tree for any queried legal entity.

Risk underwriting platforms and automated KYC agents consume this API to instantly resolve the true ownership of a business applying for credit or onboarding to a financial service. It eliminates the need for human analysts to manually cross-reference offshore registries or parse convoluted ownership declarations, removing the blind spot of hidden liabilities across international borders.

Operating as a foundational Headless SaaS layer, the API ingests raw text from government data brokers and outputs structured nodes and edges for downstream compliance agents. When the graph detects conflicting ownership claims across jurisdictions or encounters opaque offshore trusts, it outputs a low-confidence flag on the specific sub-graph, pausing the upstream onboarding agent until a human compliance officer manually verifies the corporate structure.

## Headless Saas Data Model

**Entities**:
- Name: LegalEntity · Description: A node in the structure graph representing a corporation, trust, or individual
- Name: OwnershipLink · Description: A directed edge defining ultimate beneficial ownership and subsidiary hierarchies
- Name: OfficerLink · Description: A directed edge representing board overlaps and corporate directorships
- Name: SourceDocument · Description: The ingested registry filing, SEC disclosure, or news feed source
- Name: ReviewFlag · Description: A low-confidence flag on an ownership link requiring human compliance verification
**Relations**:
- To: LegalEntity · From: OwnershipLink · Label: identifies owner · Cardinality: one-to-many
- To: LegalEntity · From: OwnershipLink · Label: identifies subsidiary · Cardinality: one-to-many
- To: SourceDocument · From: OwnershipLink · Label: extracted from · Cardinality: one-to-many
- To: LegalEntity · From: OfficerLink · Label: identifies officer · Cardinality: one-to-many
- To: LegalEntity · From: OfficerLink · Label: identifies company · Cardinality: one-to-many
- To: SourceDocument · From: OfficerLink · Label: extracted from · Cardinality: one-to-many
- To: OwnershipLink · From: ReviewFlag · Label: flags for review · Cardinality: one-to-many
**Primary Resource**: LegalEntity

## Api Definition

**Protocols**:
- GraphQL
- REST
- SDK
- MCP
- Webhooks
**Consumed By**:
- [KYC Onboarding Agent](/Agents/KYC_Onboarding_Agent)
- [Risk Underwriting Agent](/Agents/Risk_Underwriting_Agent)
- [AML Compliance Agent](/Agents/AML_Compliance_Agent)
- [Vendor Diligence Agent](/Agents/Vendor_Diligence_Agent)
**Integrations**:
- [SEC EDGAR](/Products/SEC_EDGAR)
- [OpenCorporates](/Products/OpenCorporates)
- [LexisNexis](/Products/LexisNexis)
- [UK Companies House](/Products/UK_Companies_House)
**Consumption Model**: An onboarding agent registers the MCP server to execute UBO resolution queries natively during applicant evaluation, and subscribes to webhooks for asynchronous notification when a compliance officer resolves any triggered ReviewFlags.
**Workflow Wrappers**:
- Name: Resolve Ultimate Beneficial Owner · Wraps: Queries global registries, traverses subsidiary links, and calculates aggregated ownership to identify UBOs.
- Name: Calculate Board Overlap · Wraps: Parses director databases and SEC disclosures to map shared corporate officers between entities.
- Name: Audit Entity Opacity · Wraps: Evaluates the dependency tree for offshore trusts and outputs compliance ReviewFlags for discrepancies.

## Api Function Cascade

**Ai Role**: Operating purely as stateless software consumed by higher-level agents, the API executes UBO structure resolution natively through Code, Generative, and Agentic extraction loops straight-through, exposing human intervention only via webhooks for compliance officers to clear flagged opacity exceptions.
**Cascade**:
- Kind: Code · Note: Receives the target entity MCP or GraphQL query from the consuming agent. · Step: Ingest Target Entity · Verb: ingest · Realizes: Receive Data Request · Oversight: none
- Kind: Code · Note: Fetches baseline corporate structured data from OpenCorporates and UK Companies House. · Step: Query Public Registries · Verb: query · Realizes: Retrieve Public Records · Oversight: none
- Kind: Generative · Note: Parses unstructured SEC EDGAR filings and LexisNexis reports for ownership declarations. · Step: Extract Disclosures · Verb: extract · Realizes: Extract Entity Disclosures · Oversight: none
- Kind: Agentic · Note: Iteratively maps parent-subsidiary links, triggering new queries upon detecting intermediaries. · Step: Resolve Dependency Tree · Verb: resolve · Realizes: Analyze Corporate Structures · Oversight: none
- Kind: Code · Step: Calculate Aggregated Ownership · Verb: calculate · Realizes: Calculate Aggregate Equity · Oversight: none
- Kind: Code · Note: Flags offshore trusts and discrepancies as ReviewFlags for asynchronous compliance officer resolution. · Step: Audit For Opacity · Verb: inspect · Realizes: Audit Compliance Constraints · Oversight: review-on-exception
- Kind: Code · Step: Emit Resolved Payload · Verb: transmit · Realizes: Transmit Data Payload · Oversight: none
**Optimizes**:
- [UBO Resolution Rate](/Metrics/UBO_Resolution_Rate)
- [Entity Structure Latency](/Metrics/Entity_Structure_Latency)
- [Extraction Accuracy](/Metrics/Extraction_Accuracy)
- [False Positive Flag Rate](/Metrics/False_Positive_Flag_Rate)

## Headless Saas Representative Offer

**Warranty**: Backed by a 99.9% API uptime Service Level Agreement (SLA) offering pro-rated service credits for downtime, ensuring continuous availability for automated underwriting and compliance workflows.
**Price Band**: ~$0.10 to $2.50 per entity traversal or Ultimate Beneficial Owner (UBO) resolution, depending on the depth of the corporate structure and specific registry data accessed.
**Pricing Kind**: UsageMeter
**Deliverables**:
- Programmatic access to REST, GraphQL, and MCP endpoints for entity graph queries
- Calculated Ultimate Beneficial Owner (UBO) resolution payloads
- Corporate board overlap matrices and subsidiary mappings
- Webhook configurations for asynchronous compliance ReviewFlag notifications
**Delivery Mode**: Self-serve via developer portal, with immediate issuance of API keys and MCP server configuration endpoints for instant consumption by agentic workflows.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- stored-credential

## Headless Saas Crud Surface

**Auth Model**: API Key
**Endpoints**:
- GET /legalEntities — list legal entities
- POST /legalEntities — create a new legal entity
- GET /legalEntities/{id} — fetch a specific legal entity
- PATCH /legalEntities/{id} — update a legal entity
- GET /ownershipLinks — list ownership links
- POST /ownershipLinks — create a new ownership link
- GET /ownershipLinks/{id} — fetch a specific ownership link
- PATCH /ownershipLinks/{id} — update an ownership link
- GET /officerLinks — list officer links
- POST /officerLinks — create a new officer link
- GET /officerLinks/{id} — fetch a specific officer link
- PATCH /officerLinks/{id} — update an officer link
- GET /sourceDocuments — list ingested source documents
- POST /sourceDocuments — ingest a new source document
- GET /sourceDocuments/{id} — fetch a specific source document
- PATCH /sourceDocuments/{id} — update a source document
- GET /ownershipLinks/{ownershipLinkId}/reviewFlags — list review flags for a specific ownership link
- POST /ownershipLinks/{ownershipLinkId}/reviewFlags — create a review flag on an ownership link
- GET /reviewFlags/{id} — fetch a specific review flag
- PATCH /reviewFlags/{id} — update a review flag
- POST /reviewFlags/{id}/resolve — resolve a review flag
**Multitenancy**: Row-level isolation
**Webhook Events**:
- source_document.ingested
- ownership_link.discovered
- review_flag.created
- review_flag.resolved

## Headless Saas Erd

```mermaid
erDiagram
  LegalEntity {
    UUID id PK "tenant key"
    VARCHAR legalName
    VARCHAR entityClass
    VARCHAR jurisdiction
    VARCHAR registryCode
  }
  OwnershipLink {
    UUID id PK
    UUID ownerId FK
    UUID subsidiaryId FK
    UUID sourceDocumentId FK
    DECIMAL ownershipPercentage
    BOOLEAN isUltimateBeneficialOwner
  }
  OfficerLink {
    UUID id PK
    UUID officerId FK
    UUID companyId FK
    UUID sourceDocumentId FK
    VARCHAR roleTitle
  }
  SourceDocument {
    UUID id PK
    VARCHAR documentType
    TIMESTAMP publicationDate
    VARCHAR rawTextReference
  }
  ReviewFlag {
    UUID id PK
    UUID ownershipLinkId FK
    VARCHAR flagReason
    DECIMAL confidenceScore
    VARCHAR resolutionStatus
  }
  OwnershipLink ||--o{ LegalEntity : "identifies owner"
  OwnershipLink ||--o{ LegalEntity : "identifies subsidiary"
  OwnershipLink ||--o{ SourceDocument : "extracted from"
  OfficerLink ||--o{ LegalEntity : "identifies officer"
  OfficerLink ||--o{ LegalEntity : "identifies company"
  OfficerLink ||--o{ SourceDocument : "extracted from"
  ReviewFlag ||--o{ OwnershipLink : "flags for review"
```

## Neighborhood

### Composed into

- [Tax Provision Preparation as a Service](/Services/Tax_Provision_Preparation_as_a_Service) — composes · Services

### Optimizes

- [Entity Structure Latency](/Metrics/Entity_Structure_Latency) — optimizes · Metrics
- [Extraction Accuracy](/Metrics/Extraction_Accuracy) — optimizes · Metrics
- [False Positive Flag Rate](/Metrics/False_Positive_Flag_Rate) — optimizes · Metrics
- [UBO Resolution Rate](/Metrics/UBO_Resolution_Rate) — optimizes · Metrics

### What it uses

- [LexisNexis](/Products/LexisNexis) — uses · Products
- [OpenCorporates](/Products/OpenCorporates) — uses · Products
- [SEC EDGAR](/Products/SEC_EDGAR) — uses · Products
- [UK Companies House](/Products/UK_Companies_House) — uses · Products

### Who consumes this

- [AML Compliance Agent](/Agents/AML_Compliance_Agent) — consumed by · Agents
- [KYC Onboarding Agent](/Agents/KYC_Onboarding_Agent) — consumed by · Agents
- [Risk Underwriting Agent](/Agents/Risk_Underwriting_Agent) — consumed by · Agents
- [Vendor Diligence Agent](/Agents/Vendor_Diligence_Agent) — consumed by · Agents

### Similar Startups

- [Registrylane](/Startups/Registrylane) — similar · Startups
- [Dossieromega](/Startups/Dossieromega) — similar · Startups
- [Registryloom](/Startups/Registryloom) — similar · Startups
- [Cornerstoneorb](/Startups/Cornerstoneorb) — similar · Startups
- [Sophum](/Startups/Sophum) — similar · Startups
- [Gregity](/Startups/Gregity) — similar · Startups
- [Entitypod](/Startups/Entitypod) — similar · Startups
- [Intractablemetric](/Problems/Sanctions_And_Tax_Screening/Startups/Intractablemetric) — similar · Startups
- [Corporatescope](/Startups/Corporatescope) — similar · Startups
- [Corporateharbor](/Problems/LLC_Ownership_Resolution/Startups/Corporateharbor) — similar · Startups
- [Structurenest](/Startups/Structurenest) — similar · Startups
- [Registrystack](/Startups/Registrystack) — similar · Startups

### Similar Software

- [Entity Management Software](/Metrics/On-Time_Filing_Percentage/Software/Entity_Management_Software) — similar · Software
- [Firmographic Data API](/Software/Firmographic_Data_API) — similar · Software
- [Sanctions Screening API](/Software/Sanctions_Screening_API) — similar · Software
- [Entity Filing API](/Software/Entity_Filing_API) — similar · Software
- [Contract Intelligence API](/Software/Contract_Intelligence_API) — similar · Software
- [Semantic Summarization Model](/Software/Semantic_Summarization_Model) — similar · Software
- [Tax Authority Portals](/Resources/Client_financial_data/Software/Tax_Authority_Portals) — similar · Software

### Similar Agents

- [Unstructured Payroll API](/Agents/Unstructured_Payroll_API) — similar · Agents