POST
/
api
/
external
/
companies
/
{companyId}
/
submissions
{
  "policy": {
    "type": "general_liability",
    "startsAtDate": "2024-01-01T00:00:00.000Z",
    "endsAtDate": "2024-12-31T23:59:59.000Z",
    "coverageTimezone": "America/New_York",
    "description": "General Liability Coverage for ABC Corporation"
  },
  "coverages": [
    {
      "name": "General Liability",
      "limit": 1000000,
      "premium": 2500.00,
      "deductible": 1000
    },
    {
      "name": "Products Liability",
      "limit": 1000000,
      "premium": 1500.00,
      "deductible": 1000
    }
  ],
  "insureds": [
    {
      "name": "ABC Corporation",
      "entityType": "corporation",
      "coveragePeriods": [
        {
          "joinDate": "2024-01-01T00:00:00.000Z",
          "terminationDate": "2024-12-31T23:59:59.000Z"
        }
      ]
    }
  ],
  "billing": {
    "billType": "annual",
    "paymentPlan": "annual",
    "installments": 1
  },
  "forms": {
    "selectedForms": {
      "general_liability": ["GL-001", "GL-002"]
    }
  }
}
Creates a new submission with complete policy, coverage, and insured data.
companyId
string
required
The company identifier (UUID)
policy
object
required
Complete policy information including type, dates, and description
coverages
array
required
Array of coverage objects with limits, premiums, and configuration
insureds
array
required
Array of insured parties with coverage periods and policy details
billing
object
Billing configuration including payment plan and custom items
forms
object
Forms configuration and selection

Request Body

{
  "policy": {
    "type": "general_liability",
    "startsAtDate": "2024-01-01T00:00:00.000Z",
    "endsAtDate": "2024-12-31T23:59:59.000Z",
    "coverageTimezone": "America/New_York",
    "description": "General Liability Coverage for ABC Corporation"
  },
  "coverages": [
    {
      "name": "General Liability",
      "limit": 1000000,
      "premium": 2500.00,
      "deductible": 1000
    },
    {
      "name": "Products Liability",
      "limit": 1000000,
      "premium": 1500.00,
      "deductible": 1000
    }
  ],
  "insureds": [
    {
      "name": "ABC Corporation",
      "entityType": "corporation",
      "coveragePeriods": [
        {
          "joinDate": "2024-01-01T00:00:00.000Z",
          "terminationDate": "2024-12-31T23:59:59.000Z"
        }
      ]
    }
  ],
  "billing": {
    "billType": "annual",
    "paymentPlan": "annual",
    "installments": 1
  },
  "forms": {
    "selectedForms": {
      "general_liability": ["GL-001", "GL-002"]
    }
  }
}

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "number": "SUB-2024-001",
  "status": "submitted",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z",
  "type": "new_business",
  "primaryInsuredName": "ABC Corporation",
  "applicationId": "550e8400-e29b-41d4-a716-446655440001",
  "name": "General Liability Application",
  "policy": {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "number": "POL-2024-001",
    "type": "general_liability",
    "startsAtDate": "2024-01-01T00:00:00.000Z",
    "endsAtDate": "2024-12-31T23:59:59.000Z"
  },
  "quotes": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "number": "Q-2024-001",
      "status": "active",
      "grandTotal": 4000.00
    }
  ]
}

Policy Types

  • general_liability - General Liability Insurance
  • professional_liability - Professional Liability Insurance
  • workers_compensation - Workers Compensation Insurance
  • commercial_auto - Commercial Auto Insurance
  • property - Property Insurance

Entity Types

  • corporation - Corporation
  • llc - Limited Liability Company
  • partnership - Partnership
  • sole_proprietorship - Sole Proprietorship
  • non_profit - Non-Profit Organization