Create Submission

Endpoint:

POST /api/external/companies/{companyId}/submissions

Creates a new submission.

Path Parameters

Name	Type	Required	Description
companyId	string (UUID)	Yes	Company identifier

Request Body

Key	Type	Required	Description
policy	ImportPolicy	Yes	Policy‑level details
coverages	ImportPolicyCoverage[]	Yes	Coverage lines
insureds	ImportInsured[]	Yes	Insured entities

Response

{
  "submissionId": "550e8400-e29b-41d4-a716-446655440000",
  "submissionNumber": "SUB-2024-001",
  "quoteId": "9e158e78-ab50-44af-8609-90e16ce65e46",
  "quoteNumber": "Q-2024-001",
  "importTransactionId": "f91ad4ca-8da2-4a66-b876-9d1f3392f8d3"
}

Example Requests

cURL

Create Submission Example

curl -X POST \
  'https://app.aiinsurance.io/api/external/companies/<YOUR-COMPANY-ID>/submissions' \
  -H 'Authorization: ApiKey <YOUR-API-KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "policy": {
      "policyNumber": "Example Policy No",
      "policyStartDate": "2025-09-03T00:00:00.000Z",
      "policyEndDate": "2026-09-03T23:59:59.000Z",
      "policyType": "C",
      "ratingData": {
        "companyEntityPremium": 1234,
        "highestPolicyPremium": 9876,
        "applyCapitalContribution": "yes"
      },
      "billingPeriod": "doNotSendBill",
      "policyCompanyEntityFields": {
        "policyDescription": "Sample Submission"
      }
    },
    "coverages": [
      {
        "coverageTypeId": "long_term_care_professional_liability",
        "limits": [
          {
            "limitName": "Per Claim",
            "amount": 1000000
          }
        ]
      }
    ],
    "insureds": [
      {
        "insuredName": "ABC Company",
        "joinDate": "2025-09-03T00:00:00.000Z",
        "terminationDate": "2026-09-03T00:00:00.000Z",
        "policyInsuredType": "primary",
        "entityType": "company",
        "applicationData": {
          "insuredAddress": "123 Main Street, Anytown, CA 12345, USA",
          "applyCustomCompanyPremium": "yes",
          "customCompanyPremium": 1000
        },
        "insuredCompanyEntityFields": {
          "medicalSpecialty": "Neurology"
        }
      },
      {
        "insuredName": "XYZ Healthcare Provider",
        "joinDate": "2025-09-03T00:00:00.000Z",
        "terminationDate": "2026-09-03T00:00:00.000Z",
        "policyInsuredType": "additional",
        "entityType": "elder_care_facility",
        "applicationData": {
          "insuredAddress": "555 Main Street, Anytown, CA 12345, USA",
          "midwestTerritory": "AL"
        },
        "insuredCompanyEntityFields": {
          "descriptionOperations": "Example Operations"
        }
      }
    ]
  }'