Create Quote

Creates a new Field Model V1 quote.

The policy and exposures fields contain custom field data where keys are field referenceIds defined in the company’s field configuration. Use the Configuration endpoint to discover available fields.

Lifecycle fields (quoteType, quoteStatus, quoteNumber, quoteBindErrors, quoteSubmissionId) are system-managed and will be rejected with a 400 error if included in the request.

Required permission: company.quote:create

POST /api/v1/external/companies/{companyId}/quotes

Create Quote

cURL

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/quotes \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionId": "550e8400-e29b-41d4-a716-446655440010",
  "policy": {
    "effectiveDate": "2025-01-01",
    "premium": 15000
  },
  "exposures": [
    {
      "exposureName": "Acme Corp",
      "employeeCount": 150
    }
  ]
}
'

201

success

{
  "id": "550e8400-e29b-41d4-a716-446655440001"
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

Body

application/json

submissionId · string<uuid> · required

Submission to associate the quote with

policy · object · required

Policy-level custom field data (lifecycle fields rejected)

exposures · object[] · required

Array of exposure objects with custom field data

Response

201

application/json

Quote created

id · string<uuid> · required

Newly created quote ID