Create Quote

Creates a new quote for an existing submission.

Only submissionId is required - all other fields are optional. The quote will be initialized with default values based on the submission type (new_business, renewal, endorsement, cancellation, or reinstatement).

Note: The applicant field is not supported for external API. The concept of “applicant” (human who initiated an insurance application) doesn’t apply to programmatic API calls. Use recipients to track who should receive the quote.

Required permission: company.quote:create

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

cURL

minimal

curl --request POST \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/quotes \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionId": "550e8400-e29b-41d4-a716-446655440001"
}
'

201

Example

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

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

The submission to add this quote to

policyInfo · object

Show child attributes

policyInsureds · object[]

Policy insureds (exposures) to include on this quote. Each insured must exist in the system - use the Create Insured endpoint first if needed.

Show child attributes

coverages · object[]

Line of coverage configurations

policyAggregateLimits · object[]

Aggregate limits at policy level

Show child attributes

billing · object

Billing configuration

Show child attributes

customAdjustments · object[]

Custom premium adjustments

Show child attributes

recipients · object[]

Quote recipients

Show child attributes

bindingSettings · object

Binding settings for the quote

Show child attributes

noRatingPremium · number

Manual premium (for non-rating-engine customers)

Response

201

application/json

Quote created successfully

id · string<uuid>

The ID of the created quote