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": "AB12***",
      "postcode": "SW1A***",
      "age": 30,
      "duration": 7
    },
    "vehicle": {
      "registration": "AB12***",
      "make": "FORD",
      "colour": "BLUE",
    },
    "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.4.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": "AB12***"
    },
    "vehicle": {
      "registration": "AB12***",
      "make": "FORD",
      "colour": "BLUE",
    }
  },
  "api_version": "1.4.0"
}

Note: When only a vehicle registration is provided, the API returns vehicle details including make and colour. 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.4.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")
• 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.4.0 | No authentication required | CORS enabled