Submissions and Quotes REST API

Getting Started

Base URL

https://app.aiinsurance.io

Authentication

All API requests require authentication using an API key in the request headers:

Authorization: ApiKey your-api-key-here

Rate Limits

API requests are subject to rate limiting. Please implement appropriate retry logic with exponential backoff.

Error Handling

The API uses conventional HTTP response codes to indicate success or failure:

Response

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request parameters are invalid",
    "details": {
      "field": "companyId",
      "issue": "must be a valid UUID"
    }
  }
}

Status Code	Description
200	Request successful
400	Bad Request - Invalid parameters
401	Unauthorized - Missing or invalid API key
403	Forbidden - Insufficient permissions
404	Not Found - Resource doesn’t exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

API Endpoints

Submissions

• List Submissions - Retrieve a list of submissions for a company
• Create Submission - Create a new submission with policy, coverage, and insured data
• Update Submission - Update an existing submission by creating a new quote

Quotes

• List Quotes - Retrieve quotes for a specific submission
• Get Quote - Get detailed information about a specific quote

Configuration

• Get Configuration - Retrieve company configuration including rating fields, entity types, and coverage options

Data Models

• Data Models - Complete reference for all API data structures including ImportPolicy, ImportPolicyCoverage, and ImportInsured objects