Skip to main content

​
How to Generate API Keys

API keys allow you to programmatically access your AI Insurance data and integrate with external systems. This guide shows you how to generate API keys from your company settings.

​
Step-by-Step Instructions

​
Step 1: Access Company Settings

  1. Log into your AI Insurance account at https://app.aiinsurance.io
  2. In the left sidebar, find and click on your company name (e.g., “Demo Insurance Inc.”)
  3. This will open the company settings page

​
Step 2: Navigate to API Keys

  1. In the company settings, look for the navigation bar
  2. Click on the “API Keys” tab
  3. Once you’re on the API Keys page, you will see:
    • A table of any existing API keys
    • A button to create a new API key
    • Your Company ID at the bottom of the page (this ID is required in most API requests) Find api key

​
Step 3: Create Your API Key

  1. Click the purple ”+ Create New API Key” button
  2. You’ll be prompted to enter:
    • Key Name: A descriptive name for your API key (e.g., “Production Integration”, “Testing API”)
    • Description: Optional description of what this key will be used for add key

​
Step 4: Save Your API Key

  1. After creating the key, you’ll receive your API key
  2. Store it securely - API keys grant access to your company’s data
IMPORTANT: Authentication Header FormatWhen making API requests, you MUST include your API key in the Authorization header with the exact format:
Authorization: ApiKey YOUR-API-KEY
Note the format: ApiKey (capital A and K) followed by a space, then your actual API key value.Correct:
-H "Authorization: ApiKey abc123xyz789"
Incorrect:
-H "Authorization: Bearer abc123xyz789"  ❌
-H "Authorization: abc123xyz789"         ❌
-H "X-API-Key: abc123xyz789"            ❌

​
Using Your API Key

Now that you have your API key, you can use it to access the AI Insurance External API. This API allows you to programmatically manage your insurance operations including submissions, quotes, policies, and more.

​
Getting Started with the API

See the API Overview for complete documentation - This includes:
  • All available API resources and endpoints
  • Quick start examples
  • Request/response formats
  • Data models reference

​
What You Can Do with the API

Once you have your API key, you can:
  • Submissions: Create, update, and list insurance submissions
  • Quotes: Retrieve quote information (lightweight or full details)
  • Configuration: Access your company’s rating fields and coverage types
  • More coming soon: Policies, Events, Insureds, Financials

​
Example: Using Your API Key

With your API key, you can make requests like: 
curl -X GET \
  "https://app.aiinsurance.io/api/external/companies/YOUR-COMPANY-ID/submissions" \
  -H "Authorization: ApiKey YOUR-API-KEY"