Documents API

​

Overview

​

Core endpoints

​

List documents

GET /business-entities/:businessEntityId/documents

{
  "documents": [
    {
      "id": 789,
      "fileName": "Certificate_of_Incorporation.pdf",
      "fileUrl": "https://files.example.com/certificate-of-incorporation.pdf",
      "documentType": "FORMATION_DOCUMENT",
      "documentSubType": "CertificateOfIncorporation",
      "effectiveStartDate": null,
      "effectiveEndDate": null,
      "isTimeSensitive": false,
      "isUnique": true,
      "createdAt": 1579082400000,
      "updatedAt": 1579082400000
    }
  ],
  "count": 1
}

​

Create document

POST /business-entities/:businessEntityId/documents

{
  "documentSubType": "CertificateOfIncorporation",
  "fileUrl": "https://files.example.com/certificate-of-incorporation.pdf",
  "fileName": "Certificate_of_Incorporation.pdf"
}

{
  "document": {
    "id": 789,
    "fileName": "Certificate_of_Incorporation.pdf",
    "fileUrl": "https://files.example.com/certificate-of-incorporation.pdf",
    "documentType": "FORMATION_DOCUMENT",
    "documentSubType": "CertificateOfIncorporation"
  }
}

​

Update document

PATCH /business-entities/:businessEntityId/documents/:documentId

{
  "fileUrl": "https://files.example.com/certificate-of-incorporation-amended.pdf",
  "fileName": "Certificate_of_Incorporation_Amended.pdf"
}

​

Supported documents

​

Get supported document types

GET /business-entities/:businessEntityId/documents/supported

{
  "supportedDocumentTypes": [
    {
      "documentName": "Certificate of Incorporation",
      "documentType": "FORMATION_DOCUMENT",
      "documentSubType": "CertificateOfIncorporation",
      "country": "US",
      "jurisdiction": null,
      "corporationType": "CCorp",
      "isTimeSensitive": false,
      "isUnique": true,
      "canBeAddedByAddDocument": true,
      "supportsDataStorage": false
    }
  ]
}

​

Document categories

​

Formation documents

• Certificate of Incorporation: Official incorporation certificate
• Articles of Incorporation: Corporate charter
• Bylaws: Corporate governance rules
• Operating Agreement: LLC governance document
• Memorandum of Association: Company constitution
• Articles of Association: Shareholder rights and obligations

​

Tax and compliance documents

• EIN Letter: IRS Employer Identification Number confirmation
• Tax Registration Certificate: State/national tax registration
• VAT Certificate: VAT/GST registration certificate
• PAYE Certificate: Payroll tax registration
• PF Registration: Provident fund registration
• ESIC Registration: Employee insurance registration

​

Financial records

• Balance Sheet: Statement of financial position
• Income Statement: Profit and loss statement
• Cash Flow Statement: Cash flow analysis
• Bank Statements: Monthly bank account statements
• Card Statements: Credit card statements
• Audit Reports: Annual audit documents

​

Shareholder documents

• Share Certificates: Stock ownership certificates
• Share Purchase Agreement: Equity transfer agreements
• Board Resolutions: Board meeting minutes
• Shareholder Resolutions: Shareholder meeting minutes
• Stock Option Plans: Employee equity plans

​

Contracts and agreements

• Lease Agreement: Office rental contracts
• Service Agreements: Vendor contracts
• Employment Agreements: Employee contracts
• Partnership Agreements: Business partnership documents

​

Miscellaneous

• Utility Bills: Proof of address documents
• Office Photos: Physical location verification
• Director Identification: Director ID documents
• Company Profile: Business information summaries

​

Document properties

​

Time-sensitive documents

• effectiveStartDate: When the document becomes valid
• effectiveEndDate: When the document expires (optional)

​

Unique documents

• isUnique: true: Only one instance allowed (e.g., Certificate of Incorporation)
• isUnique: false: Multiple versions allowed (e.g., Board Resolutions)

​

Service request association

• serviceRequestId: Associates the document with a specific service request when you create it
• Enables tracking of documents generated through compliance workflows

​

Jurisdiction-specific documents

​

United States (C-Corp, LLC)

• Certificate of Incorporation
• EIN Confirmation Letter
• State tax registration certificates
• Annual reports
• Franchise tax filings

​

India (Pvt Ltd, LLP)

• Certificate of Incorporation
• PAN Card
• GST Certificate
• TAN Document
• Annual audit reports

​

United Kingdom (Ltd)

• Certificate of Incorporation
• Memorandum of Association
• VAT Certificate
• PAYE Reference Letter
• HMRC UTR Letter

​

Singapore (Pte Ltd, LLP)

• Certificate of Incorporation
• GST Certificate
• CPF Activation Letter
• Articles of Association

​

Canada (Corporation)

• Certificate of Incorporation
• CRA Business Number Confirmation
• Articles of Incorporation
• Initial Return

​

UAE (Free Zone Company)

• Trade License Certificate
• TRN Letter
• Employer Establishment Card

​

Australia (Pty Ltd)

• Certificate of Incorporation
• Company Constitution
• Director’s Consent

​

Germany (GmbH)

• Notarial Deed of Incorporation
• Commercial Register Extract
• Shareholder List

​

France (SAS)

• Extrait Kbis
• Articles of Association (Statuts)
• Shareholders’ Agreement

​

File management

1. Upload the file and keep its hosted URL
2. Create the document record with that fileUrl and a fileName
3. To replace the file later, update the document with the new fileUrl and fileName

​

Related resources

• Business Entity API - Manage parent business entities
• Registrations API - Documents linked to registrations