Multi-Quote Workflow

flowchart TB
    A["POST /quotes/multi<br/>Submit 1-3 quotes"] --> B["Parallel Processing<br/>30s timeout per quote"]
    B --> C{"Results"}
    C -->|"All succeed"| D["multi_id + all quotes"]
    C -->|"Partial success"| E["multi_id + mixed results<br/>Check summary.failed"]
    C -->|"All fail"| F["multi_id + all errors"]
    D --> G["GET /quotes/multi/{id}<br/>Review before purchase"]
    E --> G
    G --> H["POST /quotes/multi/{id}/purchase<br/>Atomic: all-or-nothing"]
    H --> I["Multiple policies created"]

    style A fill:#e3f2fd
    style D fill:#e8f5e9
    style E fill:#fff3e0
    style F fill:#fce4ec
    style I fill:#e8f5e9

What This Endpoint Does

1. Batch Processing: Accepts 1-3 quote requests in a single call
2. Parallel Execution: Processes all quotes concurrently for speed
3. Independent Results: Each quote succeeds or fails independently
4. Atomic Purchase: Successful quotes can be purchased together later

When to Use This Endpoint

Call this endpoint when:

• Customer is booking multiple nights that need separate coverage
• You need quotes for different locations simultaneously
• You want to compare coverage for different amounts
• Processing multiple bookings in a batch

Request Structure

Each quote in the quotes[] array follows the standard quote format:

Understanding the Response

multi_quote object contains:

quotes[] - each item has either success or failure structure:

Success:

Failure:

summary object:

Partial Success Handling

Unlike single-quote creation, this endpoint allows partial success:

• Some quotes may succeed while others fail
• Check summary.failed to see if any quotes had issues
• Review each quotes[].status to identify failures
• Failed quotes show error details for debugging
• Successful quotes can still be purchased

Error Handling

Batch-level errors (400):

Individual quote errors (in quotes[].error):

Best Practices

1. Check summary first: Use summary.failed to quickly detect issues
2. Map by request_index: Results maintain order via request_index
3. Handle partial success: Decide whether to proceed with successful quotes only
4. Use partner_quote_id: Link each quote to your booking for tracking
5. Store multi_id: Required for batch purchase

Next Steps

After creating a multi-quote:

1. Review summary to confirm success count
2. Extract quote_ids from successful pricing_options
3. Display options to customer (can mix options from different quotes)
4. Use POST /quotes/multi/{multiId}/purchase to purchase selected quotes
5. Store multi_id and selected quote_ids for the transaction