Zixty Temporary Motor Insurance Indicative Quick Quote API

LLM-Friendly No Auth Required 4 Parameters Required

A simple, public REST API for getting indicative quick quotes for temporary car insurance in the UK. Perfect for GPT assistants, chatbots, and voice assistants.

Important: This API provides indicative quick quotes only. The final price may differ at time of purchase.

Premium quotes require all 4 parameters. LLMs can collect information from users conversationally, one parameter at a time, then make the final API call with complete information to get an indicative premium.

🎯 Key Features

📋 Quick Start

💡 Examples

Example 1: Complete Indicative Quote (All 4 Parameters Provided)

GET /v1/quote?vehicle_registration=AB12CDE&postcode=SW1A+1AA&age=30&duration=7

{
  "success": true,
  "message": "Indicative quick quote calculated successfully. Note: This is an indicative quote only - final price may differ at time of purchase.",
  "quote": {
    "quote_status": "complete",
    "missing_fields": [],
    "inputs_provided": {
      "vehicle_registration": "AB12CDE",
      "postcode": "SW1A 1AA",
      "age": 30,
      "duration": 7
    },
    "vehicle": {
      "registration": "AB12CDE",
      "make": "FORD",
      "model": "FOCUS",
      "colour": "BLUE",
      "insurance_group": 15
    },
    "premium_gbp": 53.13
  },
  "next_steps": {
    "action": "complete_purchase",
    "url": "https://quote.zixty.com/quote/direct/vehicle?ref=abc123...",
    "description": "Visit this URL to complete your purchase and get your temporary cover"
  },
  "api_version": "1.2.0"
}

Note: This is an indicative quick quote. Premium is only shown when all 4 required parameters are provided. The user is directed to the main Zixty quote site to complete their purchase, where the final price may differ. The URL includes a short-lived referral token (?ref=...) so the user's details are pre-filled.

Example 2: Partial Quote (Vehicle Registration Only)

GET /v1/quote?vehicle_registration=AB12CDE

{
  "success": true,
  "message": "Vehicle details retrieved. Please provide: postcode, age, duration.",
  "quote": {
    "quote_status": "incomplete",
    "missing_fields": ["postcode", "age", "duration"],
    "inputs_provided": {
      "vehicle_registration": "AB12CDE"
    },
    "vehicle": {
      "registration": "AB12CDE",
      "make": "FORD",
      "model": "FOCUS",
      "colour": "BLUE",
      "insurance_group": 15
    }
  },
  "api_version": "1.2.0"
}

Note: When only a vehicle registration is provided, the API returns vehicle details including make, model, colour, and predicted insurance group. LLMs can use this to confirm the vehicle with the user before collecting other details.

Example 3: Incomplete Request (Missing VRN)

GET /v1/quote?postcode=SW1A+1AA&age=30&duration=7

{
  "success": true,
  "message": "Please provide the following information to get an indicative quote: vehicle_registration.",
  "quote": {
    "quote_status": "incomplete",
    "missing_fields": ["vehicle_registration"],
    "inputs_provided": {
      "postcode": "SW1A 1AA",
      "age": 30,
      "duration": 7
    }
  },
  "api_version": "1.2.0"
}

Validation Error

GET /v1/quote?vehicle_registration=AB12CDE&postcode=SW1A+1AA&age=15&duration=7

{
  "success": false,
  "error": "validation_failed",
  "validation_errors": [
    "Age is too low (minimum: 18 years)"
  ],
  "acceptable_ranges": {
    "age": "18-90 years",
    "duration": "1-28 days",
    "postcode": "UK postcodes"
  }
}

🤖 For LLM/GPT Integration

This API is designed to be discovered and used by Large Language Models:

• OpenAPI Schema: /v1/openapi.json
• Parameter collection workflow: The missing_fields array guides what information to collect from users
• Premium only on complete: LLMs should collect all 4 parameters before expecting a premium quote
• Validation guidance: Error responses include acceptable ranges
• Stateless: Each request is independent - no session management needed
• Next steps included: Complete quotes include a URL to direct users to Zixty's main quote site for purchase

📊 Response Fields

• quote_status - "complete" or "incomplete"
• missing_fields - Array of parameters still needed (empty when complete)
• inputs_provided - What you sent
• vehicle - Vehicle details when VRN is provided:
  • registration - Normalized vehicle registration
  • make - Vehicle manufacturer (e.g., "FORD")
  • model - Vehicle model (e.g., "FOCUS")
  • colour - Vehicle colour (e.g., "BLUE")
  • insurance_group - AI-predicted insurance group (1-50)
• premium_gbp - Indicative premium in GBP (only present when all 4 parameters provided). This is an indicative quote only - final price may differ at time of purchase.
• next_steps - URL and instructions for completing purchase where final pricing will be confirmed (only present for complete quotes)

🔗 Additional Resources

• OpenAPI Schema (JSON)
• API Root
• Health Check

Zixty Temporary Motor Insurance API v1.2.0 | No authentication required | CORS enabled