# Entity Filing API

*/Software/Entity_Filing_API*

## Solution Overview

Entity Filing API programmatically submits formation documents, articles of incorporation, and initial reports directly to state Secretary of State databases. It converts standardized JSON payloads into state-specific PDF forms, web-based submissions, or proprietary EDI formats, handling the exact schema requirements and filing fee transactions for all 50 US jurisdictions. The immediate output is a verified state file number, registered agent assignment, and digitally stamped formation certificate returned to the requesting application.

FinTech platforms, digital banking providers, and automated legal service agents consume this API to embed business formation natively within their onboarding flows. It eliminates the need for internal operations teams to manually navigate fragmented state government portals, maintain continuous updates to 50 distinct sets of compliance rules, or manage physical check mailings for jurisdictions that lack modern digital infrastructure.

Operating as a headless SaaS primitive, the API sits below customer-facing incorporation agents and commercial banking software. It ingests identity verification data and payment routing instructions from the host application while interacting directly with disparate state government systems. Because business formation establishes permanent legal liability, the API enforces a strict human-in-the-loop checkpoint, requiring the host application to secure and transmit a verifiable digital signature from the human founder before executing the final state submission.

## Headless Saas Data Model

**Entities**:
- Name: FormationRequest · Description: Core entity representing the submission of formation documents to a state jurisdiction
- Name: Workspace · Description: The FinTech platform or digital bank consuming the API
- Name: Jurisdiction · Description: A US state and its specific corporate filing requirements and fee structures
- Name: Founder · Description: A human individual required to provide a digital signature for formation liability
- Name: RegisteredAgent · Description: Assigned legal representative for the entity in the specific jurisdiction
- Name: FilingTransaction · Description: Financial ledger record for state filing fees and routing instructions
**Relations**:
- To: FormationRequest · From: Workspace · Label: submits · Cardinality: one-to-many
- To: FormationRequest · From: Jurisdiction · Label: governs · Cardinality: one-to-many
- To: FormationRequest · From: RegisteredAgent · Label: represents · Cardinality: one-to-many
- To: Founder · From: FormationRequest · Label: requires signature from · Cardinality: one-to-many
- To: FilingTransaction · From: FormationRequest · Label: incurs fees through · Cardinality: one-to-many
- To: RegisteredAgent · From: Workspace · Label: manages · Cardinality: one-to-many
- To: RegisteredAgent · From: Jurisdiction · Label: authorizes · Cardinality: one-to-many
**Tenant Anchor**: Workspace
**Primary Resource**: FormationRequest

## Api Definition

**Protocols**:
- REST
- SDK
- MCP
- Webhooks
**Consumed By**:
- [Legal Incorporation Agent](/Agents/Legal_Incorporation_Agent)
- [Business Onboarding Agent](/Agents/Business_Onboarding_Agent)
- [Commercial Account Opening Agent](/Agents/Commercial_Account_Opening_Agent)
**Integrations**:
- [Delaware Division of Corporations](/Products/Delaware_Division_of_Corporations)
- [California Secretary of State](/Products/California_Secretary_of_State)
- [DocuSign](/Products/DocuSign)
- [Stripe](/Products/Stripe)
**Consumption Model**: A business onboarding agent calls the execute_entity_formation tool via MCP and subscribes to the formation.certified webhook to retrieve the state file number and stamped certificate.
**Workflow Wrappers**:
- Name: Execute Entity Formation · Wraps: transforms standard JSON into state-specific formats, processes fees, and submits to the jurisdiction
- Name: Enforce Signature Checkpoint · Wraps: pauses the pipeline to request and verify the mandated human founder digital signature
- Name: Provision Registered Agent · Wraps: evaluates jurisdiction requirements and binds an authorized local representative to the formation request

## Api Function Cascade

**Ai Role**: The Entity Filing API is a fully digital, stateless SaaS primitive that executes jurisdiction routing, data formatting, and state submissions straight-through via code, pausing only at a mandated integration checkpoint to await external human approval via a founder's digital signature.
**Cascade**:
- Kind: Code · Note: Accepts standard JSON formation payload via REST or MCP · Step: Ingest Formation Request · Verb: ingest · Realizes: Receive Service Request · Oversight: none
- Kind: Code · Note: Evaluates jurisdiction rules and assigns a local representative · Step: Bind Registered Agent · Verb: allocate · Realizes: Assign Resource Requirements · Oversight: none
- Kind: Code · Note: Pauses pipeline to await mandated founder signature via DocuSign · Step: Enforce Signature Checkpoint · Verb: verify · Realizes: Verify Authorizing Signatures · Oversight: approves
- Kind: Code · Note: Transforms JSON into strict California or Delaware structures · Step: Map State-Specific Formats · Verb: transform · Realizes: Format Documentation · Oversight: none
- Kind: Code · Note: Processes jurisdiction-specific incorporation fees via Stripe · Step: Remit Filing Fees · Verb: process · Realizes: Process Fee Payments · Oversight: none
- Kind: Code · Note: Transmits to state agency and emits certified webhook · Step: Submit to Jurisdiction · Verb: submit · Realizes: Submit Regulatory Filings · Oversight: none
**Optimizes**:
- [Filing Acceptance Rate](/Metrics/Filing_Acceptance_Rate)
- [End-to-End Turnaround Time](/Metrics/End-to-End_Turnaround_Time)
- [Signature Completion Rate](/Metrics/Signature_Completion_Rate)
- [First-Pass Yield](/Metrics/First-Pass_Yield)

## Headless Saas Representative Offer

**Warranty**: Commits to 99.9% API uptime and provides an automated refund of API processing fees if a filing is rejected by the jurisdiction due to schema mistranslation.
**Price Band**: ~$40 to $150 per executed entity formation, depending on the jurisdiction and excluding pass-through state statutory fees
**Pricing Kind**: UsageMeter
**Deliverables**:
- Normalized JSON-to-state-schema payload translation
- Automated registered agent binding
- Digital signature collection checkpoint
- State file number and stamped certificate delivery via webhook
**Delivery Mode**: Self-serve API metering where the buyer provisions access instantly and triggers asynchronous state filing pipelines programmatically.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- stored-credential

## Headless Saas Crud Surface

**Auth Model**: API Key
**Endpoints**:
- GET /formation-requests — list formation requests
- POST /formation-requests — create a new formation request
- GET /formation-requests/{id} — fetch a specific formation request
- PATCH /formation-requests/{id} — update a formation request
- POST /formation-requests/{id}/submit — submit the formation request to the state jurisdiction
- GET /workspaces — list workspaces
- POST /workspaces — create a new workspace
- GET /workspaces/{id} — fetch a specific workspace
- PATCH /workspaces/{id} — update a workspace
- GET /jurisdictions — list supported jurisdictions
- POST /jurisdictions — add a new jurisdiction
- GET /jurisdictions/{id} — fetch jurisdiction details and requirements
- PATCH /jurisdictions/{id} — update jurisdiction details
- GET /formation-requests/{formationRequestId}/founders — list founders attached to a formation request
- POST /formation-requests/{formationRequestId}/founders — add a founder to a formation request
- GET /formation-requests/{formationRequestId}/founders/{id} — fetch a specific founder
- PATCH /formation-requests/{formationRequestId}/founders/{id} — update founder details
- POST /formation-requests/{formationRequestId}/founders/{id}/sign — record a digital signature from the founder
- GET /workspaces/{workspaceId}/registered-agents — list registered agents managed by the workspace
- POST /workspaces/{workspaceId}/registered-agents — provision a registered agent for the workspace
- GET /workspaces/{workspaceId}/registered-agents/{id} — fetch a specific registered agent
- PATCH /workspaces/{workspaceId}/registered-agents/{id} — update registered agent details
- GET /formation-requests/{formationRequestId}/filing-transactions — list filing transactions for a request
- POST /formation-requests/{formationRequestId}/filing-transactions — create a new filing transaction
- GET /formation-requests/{formationRequestId}/filing-transactions/{id} — fetch a specific filing transaction
- PATCH /formation-requests/{formationRequestId}/filing-transactions/{id} — update a filing transaction
- POST /formation-requests/{formationRequestId}/filing-transactions/{id}/process — execute the payment routing instructions
**Multitenancy**: Row-level isolation
**Webhook Events**:
- formation_request.submitted
- formation_request.accepted
- formation_request.rejected
- founder.signed
- filing_transaction.settled

## Headless Saas Erd

```mermaid
erDiagram
FormationRequest {
UUID id PK
UUID workspaceId FK
UUID jurisdictionId FK
UUID registeredAgentId FK
VARCHAR entityName
VARCHAR stateFileNumber
VARCHAR status
}
Workspace {
UUID id PK "TenantKey"
VARCHAR name
VARCHAR environment
VARCHAR apiKey
}
Jurisdiction {
UUID id PK
VARCHAR stateCode
DECIMAL baseFilingFee
BOOLEAN acceptsDigitalFiling
}
Founder {
UUID id PK
UUID formationRequestId FK
VARCHAR fullName
VARCHAR signatureStatus
TIMESTAMP signatureTimestamp
}
RegisteredAgent {
UUID id PK
UUID workspaceId FK
UUID jurisdictionId FK
VARCHAR legalName
VARCHAR physicalAddress
}
FilingTransaction {
UUID id PK
UUID formationRequestId FK
DECIMAL amount
JSONB routingInstructions
VARCHAR paymentStatus
}
Workspace ||--o{ FormationRequest : submits
Jurisdiction ||--o{ FormationRequest : governs
RegisteredAgent ||--o{ FormationRequest : represents
FormationRequest ||--o{ Founder : "requires signature from"
FormationRequest ||--o{ FilingTransaction : "incurs fees through"
Workspace ||--o{ RegisteredAgent : manages
Jurisdiction ||--o{ RegisteredAgent : authorizes
```

## Neighborhood

### Composed into

- [Entryreserve Entity Agent](/Agents/Entryreserve_Entity_Agent) — composes · Agents

### Optimizes

- [End-to-End Turnaround Time](/Metrics/End-to-End_Turnaround_Time) — optimizes · Metrics
- [Filing Acceptance Rate](/Metrics/Filing_Acceptance_Rate) — optimizes · Metrics
- [First-Pass Yield](/Metrics/First-Pass_Yield) — optimizes · Metrics
- [Signature Completion Rate](/Metrics/Signature_Completion_Rate) — optimizes · Metrics

### What it uses

- [Delaware Division of Corporations](/Products/Delaware_Division_of_Corporations) — uses · Products
- [DocuSign](/Products/DocuSign) — uses · Products
- [Stripe](/Software/Stripe) — uses · Software
- [California Secretary of State](/Products/California_Secretary_of_State) — uses · Products

### Who consumes this

- [Business Onboarding Agent](/Agents/Business_Onboarding_Agent) — consumed by · Agents
- [Commercial Account Opening Agent](/Agents/Commercial_Account_Opening_Agent) — consumed by · Agents
- [Legal Incorporation Agent](/Agents/Legal_Incorporation_Agent) — consumed by · Agents

### Similar Software

- [Entity Management Software](/Metrics/On-Time_Filing_Percentage/Software/Entity_Management_Software) — similar · Software
- [Compliance Management Systems](/Metrics/On-Time_Filing_Percentage/Software/Compliance_Management_Systems) — similar · Software
- [Entity Structure Graph API](/Software/Entity_Structure_Graph_API) — similar · Software
- [Tax Authority Portals](/Resources/Client_financial_data/Software/Tax_Authority_Portals) — similar · Software
- [Permit Application Software](/Resources/Regulatory_code_databases/Software/Permit_Application_Software) — similar · Software
- [Tax Preparation Software](/Metrics/On-Time_Filing_Percentage/Software/Tax_Preparation_Software) — similar · Software
- [Contract Intelligence API](/Software/Contract_Intelligence_API) — similar · Software
- [Firmographic Data API](/Software/Firmographic_Data_API) — similar · Software
- [Identity Verification APIs](/Metrics/KYC_Cycle_Time/Software/Identity_Verification_APIs) — similar · Software
- [Fintech Core Ledgers](/Resources/Regulatory_code_databases/Software/Fintech_Core_Ledgers) — similar · Software
- [Platform Identity API](/Software/Platform_Identity_API) — similar · Software
- [Sanctions Screening API](/Software/Sanctions_Screening_API) — similar · Software

### Similar Startups

- [Registrylane](/Startups/Registrylane) — similar · Startups
- [Registrystack](/Startups/Registrystack) — similar · Startups
- [Chamberlane](/Startups/Chamberlane) — similar · Startups
- [VouchLink API](/Startups/VouchLink_API) — similar · Startups
- [Entitypod](/Startups/Entitypod) — similar · Startups

### Similar Markets

- [Fully Automated E-Filing Services](/Markets/Fully_Automated_E-Filing_Services) — similar · Markets

### Similar Customers

- [Corporate Secretaries](/Customers/Corporate_Secretaries) — similar · Customers