Build entity management into your product.

Entity formation

• POST /v1/entities - Create a new LLC, Corp, or Nonprofit. Returns entity ID and filing status.
• GET /v1/entities/{id} - Retrieve entity record and current filing status.
• GET /v1/entities - List entities (paginated, filterable).
• PATCH /v1/entities/{id} - Update entity metadata (does not change state record without a separate amendment call).

BOI reporting

• POST /v1/boi/reports - File a new BOI report. Initial or update.
• GET /v1/boi/reports/{id} - Retrieve report status and FinCEN confirmation.
• POST /v1/boi/reports/batch - Submit multiple BOI reports in one request (up to 500).

Documents

• GET /v1/entities/{id}/documents - List documents stored for an entity.
• GET /v1/documents/{id} - Retrieve a specific document (returns a signed S3 URL valid for 15 minutes).
• POST /v1/documents - Upload a new document to the vault.

Registered Agent

• POST /v1/registered-agent - Designate us as RA in a specified state.
• GET /v1/registered-agent/mail - Retrieve scanned mail received at the RA address.

Compliance

• GET /v1/compliance/calendar - Get upcoming filings for one or more entities.
• POST /v1/compliance/file - Authorize a specific filing (annual report, franchise tax, foreign qualification).

Webhooks

Subscribe to events via webhook URL. Standard events:

• entity.created
• entity.state_filed
• entity.state_approved
• boi.filed
• boi.confirmed
• document.uploaded
• compliance.upcoming (configurable lead time)
• registered_agent.mail_received

Webhooks are signed with HMAC-SHA256. Signature verification is documented in the developer portal.

Authentication

Bearer token authentication with API keys scoped per workspace. Keys can be limited to read-only, write, or full access. OAuth 2.0 for third-party developers building on top of File.Business.

Rate limits

1,000 requests per minute on the standard tier. Higher rate limits available on enterprise tiers with annual commit.

Sandbox

A separate sandbox environment (sandbox.file.business) lets you test all API endpoints without filing real entities with the state. Sandbox keys are free for all customers.

SDKs

• file-business-python - pip install file-business
• file-business-node - npm install file-business
• file-business-ruby - gem install file-business
• file-business-go - go get github.com/filebusiness/go-sdk

OpenAPI spec

The full OpenAPI 3.1 specification is available at api.file.business/v1/openapi.json. Generate clients in any language; import into Postman, Insomnia, or your tool of choice.

Getting access

Public API access is currently invite-only. Request access by contacting our developer relations team. We onboard new API customers within 2 business days.