{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/coveragecat-com/json-schema/coveragecat-com-intake-assistant-response-schema.json",
  "title": "IntakeAssistantResponse",
  "description": "REST consumer follow-up payload for the `/api/intake/{uid}` surface.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/coveragecat-com-agent-openapi.yml#/components/schemas/IntakeAssistantResponse",
  "additionalProperties": false,
  "properties": {
    "contact_preferences_disclosures": {
      "additionalProperties": false,
      "description": "Optional versioned service-contact disclosures for the phone number on file; no marketing consent and no purchase requirement.",
      "properties": {
        "service_call": {
          "additionalProperties": false,
          "description": "Optional service-call disclosure; show its text verbatim before recording a choice.",
          "properties": {
            "kind": {
              "const": "service_call",
              "type": "string"
            },
            "text": {
              "minLength": 1,
              "type": "string"
            },
            "text_hash": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "version": {
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "kind",
            "version",
            "text",
            "text_hash"
          ],
          "type": "object"
        },
        "service_sms": {
          "additionalProperties": false,
          "description": "Optional service-text disclosure; show its text verbatim before recording a choice.",
          "properties": {
            "kind": {
              "const": "service_sms",
              "type": "string"
            },
            "text": {
              "minLength": 1,
              "type": "string"
            },
            "text_hash": {
              "pattern": "^[a-f0-9]{64}$",
              "type": "string"
            },
            "version": {
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "kind",
            "version",
            "text",
            "text_hash"
          ],
          "type": "object"
        }
      },
      "type": "object"
    },
    "post_choose": {
      "additionalProperties": true,
      "description": "Structured post-choose state after a quoted umbrella offer is selected.",
      "type": "object"
    },
    "next_action": {
      "additionalProperties": true,
      "description": "A structured hint for the next allowed tool or endpoint action.",
      "type": "object"
    },
    "required_upload_types": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "service_preview": {
      "additionalProperties": false,
      "properties": {
        "action_summary": {
          "type": "string"
        },
        "approval_required": {
          "type": "boolean"
        },
        "billing_effect": {
          "type": "string"
        },
        "carrier_conditions": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "coverage_effect": {
          "type": "string"
        },
        "details": {
          "type": "string"
        },
        "estimated_refund_status": {
          "enum": [
            "not_applicable",
            "unknown_pending_review"
          ],
          "type": "string"
        },
        "reason": {
          "type": "string"
        },
        "request_type": {
          "enum": [
            "policy_cancellation",
            "refund_request",
            "support_case"
          ],
          "type": "string"
        },
        "requested_effective_date": {
          "format": "date",
          "type": "string"
        },
        "status": {
          "enum": [
            "preview"
          ],
          "type": "string"
        },
        "uncertainty": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "credit_consent_question": {
      "type": "string"
    },
    "detail_status": {
      "enum": [
        "abandoned",
        "blocked",
        "bound",
        "cancelled",
        "chosen",
        "credit_consent_pending",
        "credit_consent_required",
        "dev_success",
        "documents_needed",
        "documents_pending_review",
        "email_sent",
        "in_review",
        "ineligible",
        "info_requested",
        "needs_more_info",
        "needs_more_info_to_bind",
        "no_policy",
        "no_chosen_offer",
        "no_quotes",
        "no_selection",
        "ok",
        "payment_collection_ready",
        "payment_needed",
        "pending",
        "pending_quotes",
        "queued",
        "quote_rate_limited",
        "quoted",
        "ready_for_review",
        "ready_for_submission",
        "ready_to_finalize",
        "review_pending",
        "service_preview",
        "service_requested",
        "sandbox_unsupported",
        "stale_selection",
        "verifying_documents",
        "waiting_on_carrier",
        "waiting_on_documents",
        "waiting_on_payment"
      ],
      "type": "string"
    },
    "expires_at": {
      "description": "When the current consumer handoff expires.",
      "format": "date-time",
      "type": "string"
    },
    "selected_offer": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "additionalProperties": false,
          "properties": {
            "city": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "street": {
              "type": "string"
            },
            "zip": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "annual_price": {
          "type": "number"
        },
        "carrier": {
          "type": "string"
        },
        "coverage_limit": {
          "type": "string"
        },
        "coverage_summary": {
          "additionalProperties": true,
          "description": "Homeowners or umbrella coverage details Coverage Cat can safely summarize.",
          "type": "object"
        },
        "deductible": {
          "type": "number"
        },
        "dwelling_coverage": {
          "type": "number"
        },
        "is_estimate": {
          "type": "boolean"
        },
        "minimum_auto_limits": {
          "additionalProperties": true,
          "description": "Underlying auto-limit requirements for this offer.",
          "type": "object"
        },
        "personal_liability": {
          "type": "number"
        },
        "policy_subtype": {
          "type": "string"
        },
        "policy_subtype_display": {
          "type": "string"
        },
        "price_range": {
          "additionalProperties": false,
          "properties": {
            "high": {
              "type": "number"
            },
            "low": {
              "type": "number"
            }
          },
          "type": "object"
        },
        "quote_number": {
          "type": "string"
        },
        "recommended": {
          "type": "boolean"
        },
        "sample_policy_url": {
          "format": "uri",
          "type": "string"
        },
        "selection_guidance": {
          "additionalProperties": true,
          "description": "Offer-specific same-reply requirements and guidance.",
          "type": "object"
        },
        "selection_token": {
          "type": "string"
        },
        "um_uim_selection": {
          "additionalProperties": true,
          "description": "Optional excess UM/UIM election details for this offer.",
          "type": "object"
        }
      },
      "type": "object"
    },
    "schema": {
      "additionalProperties": true,
      "description": "Supplemental schema hints for homeowners review payloads.",
      "type": "object"
    },
    "line": {
      "enum": [
        "umbrella",
        "homeowners"
      ],
      "type": "string"
    },
    "pending_fields": {
      "description": "Structured missing-value hints for umbrella pre-submit review.",
      "items": {
        "additionalProperties": true,
        "description": "Structured missing-value hints for umbrella pre-submit review.",
        "type": "object"
      },
      "type": "array"
    },
    "uploaded_count": {
      "type": "integer"
    },
    "offers": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "additionalProperties": false,
            "properties": {
              "city": {
                "type": "string"
              },
              "state": {
                "type": "string"
              },
              "street": {
                "type": "string"
              },
              "zip": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "annual_price": {
            "type": "number"
          },
          "carrier": {
            "type": "string"
          },
          "coverage_limit": {
            "type": "string"
          },
          "coverage_summary": {
            "additionalProperties": true,
            "description": "Homeowners or umbrella coverage details Coverage Cat can safely summarize.",
            "type": "object"
          },
          "deductible": {
            "type": "number"
          },
          "dwelling_coverage": {
            "type": "number"
          },
          "is_estimate": {
            "type": "boolean"
          },
          "minimum_auto_limits": {
            "additionalProperties": true,
            "description": "Underlying auto-limit requirements for this offer.",
            "type": "object"
          },
          "personal_liability": {
            "type": "number"
          },
          "policy_subtype": {
            "type": "string"
          },
          "policy_subtype_display": {
            "type": "string"
          },
          "price_range": {
            "additionalProperties": false,
            "properties": {
              "high": {
                "type": "number"
              },
              "low": {
                "type": "number"
              }
            },
            "type": "object"
          },
          "quote_number": {
            "type": "string"
          },
          "recommended": {
            "type": "boolean"
          },
          "sample_policy_url": {
            "format": "uri",
            "type": "string"
          },
          "selection_guidance": {
            "additionalProperties": true,
            "description": "Offer-specific same-reply requirements and guidance.",
            "type": "object"
          },
          "selection_token": {
            "type": "string"
          },
          "um_uim_selection": {
            "additionalProperties": true,
            "description": "Optional excess UM/UIM election details for this offer.",
            "type": "object"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "response_summary": {
      "type": "string"
    },
    "payment_status": {
      "additionalProperties": false,
      "properties": {
        "channel": {
          "type": "string"
        },
        "customer_owned_inbox_required": {
          "type": "boolean"
        },
        "destination_hint": {
          "type": "string"
        },
        "payment_intent_id": {
          "type": "string"
        },
        "payment_method_saved_at": {
          "format": "date-time",
          "type": "string"
        },
        "provider": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "timing": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "poll_after_seconds": {
      "type": "integer"
    },
    "uid": {
      "description": "Coverage Cat intake uid for the current handoff.",
      "type": "string"
    },
    "conversation": {
      "additionalProperties": false,
      "properties": {
        "messages": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "author_label": {
                "type": "string"
              },
              "delivery_state": {
                "enum": [
                  "received",
                  "queued",
                  "sent"
                ],
                "type": "string"
              },
              "direction": {
                "enum": [
                  "incoming",
                  "outgoing"
                ],
                "type": "string"
              },
              "medium": {
                "enum": [
                  "email",
                  "app",
                  "sms"
                ],
                "type": "string"
              },
              "message_id": {
                "type": "integer"
              },
              "subject": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "timestamp": {
                "format": "date-time",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "reply_pending": {
          "type": "boolean"
        },
        "reply_supported": {
          "type": "boolean"
        },
        "reply_to_message_id": {
          "type": "integer"
        },
        "reply_via": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "compare_details_url": {
      "description": "Coverage Cat browser URL for compare-details follow-up.",
      "format": "uri",
      "type": "string"
    },
    "offer_summary": {
      "additionalProperties": false,
      "properties": {
        "cheapest_annual_premium": {
          "type": "number"
        },
        "cheapest_carrier": {
          "type": "string"
        },
        "quote_count": {
          "type": "integer"
        },
        "recommended_annual_premium": {
          "type": "number"
        },
        "recommended_carrier": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "review_token": {
      "description": "Opaque review token for delegated review-style submit paths.",
      "type": "string"
    },
    "status": {
      "enum": [
        "abandoned",
        "blocked",
        "bound",
        "cancelled",
        "chosen",
        "credit_consent_pending",
        "credit_consent_required",
        "dev_success",
        "documents_needed",
        "documents_pending_review",
        "email_sent",
        "in_review",
        "ineligible",
        "info_requested",
        "needs_more_info",
        "needs_more_info_to_bind",
        "no_policy",
        "no_chosen_offer",
        "no_quotes",
        "no_selection",
        "ok",
        "payment_collection_ready",
        "payment_needed",
        "pending",
        "pending_quotes",
        "queued",
        "quote_rate_limited",
        "quoted",
        "ready_for_review",
        "ready_for_submission",
        "ready_to_finalize",
        "review_pending",
        "service_preview",
        "service_requested",
        "sandbox_unsupported",
        "stale_selection",
        "verifying_documents",
        "waiting_on_carrier",
        "waiting_on_documents",
        "waiting_on_payment"
      ],
      "type": "string"
    },
    "preview_token": {
      "description": "Opaque bind-preview token for the next homeowners bind confirmation.",
      "type": "string"
    },
    "next_question": {
      "additionalProperties": true,
      "description": "The current shopper-owned question bundle or bind-stage question.",
      "type": "object"
    },
    "review_estimates": {
      "items": {
        "additionalProperties": true,
        "description": "Coverage Cat estimate provenance metadata for reviewed values.",
        "type": "object"
      },
      "type": "array"
    },
    "known_summary": {
      "additionalProperties": true,
      "description": "Structured facts Coverage Cat can safely summarize at this stage.",
      "type": "object"
    },
    "user_action_required": {
      "type": "string"
    },
    "payment_collection_supported": {
      "type": "boolean"
    },
    "offers_url": {
      "description": "Coverage Cat browser URL for the selected offer or offer-tracking page.",
      "format": "uri",
      "type": "string"
    },
    "service_request": {
      "additionalProperties": false,
      "properties": {
        "action_summary": {
          "type": "string"
        },
        "billing_effect": {
          "type": "string"
        },
        "carrier_conditions": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "coverage_effect": {
          "type": "string"
        },
        "details": {
          "type": "string"
        },
        "estimated_refund_status": {
          "enum": [
            "not_applicable",
            "unknown_pending_review"
          ],
          "type": "string"
        },
        "final_outcome": {
          "additionalProperties": true,
          "description": "Final carrier or billing outcome once Coverage Cat can confirm it.",
          "type": "object"
        },
        "reason": {
          "type": "string"
        },
        "request_id": {
          "type": "string"
        },
        "request_type": {
          "enum": [
            "policy_cancellation",
            "refund_request",
            "support_case"
          ],
          "type": "string"
        },
        "requested_at": {
          "format": "date-time",
          "type": "string"
        },
        "requested_effective_date": {
          "format": "date",
          "type": "string"
        },
        "status": {
          "enum": [
            "pending_review",
            "completed"
          ],
          "type": "string"
        },
        "uncertainty": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "review": {
      "additionalProperties": true,
      "description": "Structured review card or selected-offer review block.",
      "type": "object"
    },
    "sandbox": {
      "description": "True when Coverage Cat is returning consumer sandbox test data rather than a live shopper workflow.",
      "type": "boolean"
    },
    "selection_guidance": {
      "additionalProperties": true,
      "description": "Guidance for completing an offer choice in one shopper-facing reply.",
      "type": "object"
    },
    "documents": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "content_type": {
            "type": "string"
          },
          "download_url": {
            "description": "Short-lived browser continuation for this policy document.",
            "format": "uri",
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "notification_channel": {
      "additionalProperties": false,
      "properties": {
        "customer_owned_inbox_required": {
          "type": "boolean"
        },
        "destination_hint": {
          "type": "string"
        },
        "events": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "registered": {
          "type": "boolean"
        },
        "role": {
          "type": "string"
        },
        "type": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "support": {
      "additionalProperties": false,
      "properties": {
        "contact_url": {
          "description": "Coverage Cat support route for billing, cancellations, and quote follow-up.",
          "format": "uri",
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "purchase_preview": {
      "additionalProperties": false,
      "properties": {
        "action_summary": {
          "type": "string"
        },
        "approval_required": {
          "type": "boolean"
        },
        "carrier_conditions": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "coverage_summary": {
          "additionalProperties": true,
          "description": "Coverage details tied to the current previewed offer.",
          "type": "object"
        },
        "effective_date": {
          "format": "date",
          "type": "string"
        },
        "effective_period": {
          "additionalProperties": false,
          "properties": {
            "ends_on": {
              "format": "date",
              "type": "string"
            },
            "starts_on": {
              "format": "date",
              "type": "string"
            }
          },
          "type": "object"
        },
        "payment_timing": {
          "type": "string"
        },
        "price": {
          "additionalProperties": false,
          "properties": {
            "annual_premium": {
              "type": "number"
            },
            "currency": {
              "type": "string"
            },
            "payment_method": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "status": {
          "type": "string"
        },
        "uncertainty": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "uploaded": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "filename": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "payment_ui": {
      "additionalProperties": false,
      "properties": {
        "availability": {
          "enum": [
            "ready",
            "unknown",
            "unsupported"
          ],
          "type": "string"
        },
        "fallback_reason": {
          "type": "string"
        },
        "mode": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "field_estimates": {
      "items": {
        "additionalProperties": true,
        "description": "Coverage Cat estimate provenance metadata for reviewed values.",
        "type": "object"
      },
      "type": "array"
    },
    "credit_consent_disclosure": {
      "additionalProperties": false,
      "description": "Versioned canonical text that must be shown verbatim; echo version and text_hash with the user's response.",
      "properties": {
        "kind": {
          "const": "credit_report",
          "type": "string"
        },
        "text": {
          "minLength": 1,
          "type": "string"
        },
        "text_hash": {
          "pattern": "^[a-f0-9]{64}$",
          "type": "string"
        },
        "version": {
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "kind",
        "version",
        "text",
        "text_hash"
      ],
      "type": "object"
    },
    "policy": {
      "additionalProperties": false,
      "properties": {
        "cancellation_note": {
          "type": "string"
        },
        "cancelled_at": {
          "format": "date",
          "type": "string"
        },
        "carrier": {
          "type": "string"
        },
        "confirmation_timestamp": {
          "format": "date-time",
          "type": "string"
        },
        "coverage_summary": {
          "additionalProperties": true,
          "description": "Carrier-confirmed policy coverage details Coverage Cat can safely return.",
          "type": "object"
        },
        "effective_date": {
          "format": "date",
          "type": "string"
        },
        "effective_period": {
          "additionalProperties": false,
          "properties": {
            "ends_on": {
              "format": "date",
              "type": "string"
            },
            "starts_on": {
              "format": "date",
              "type": "string"
            }
          },
          "type": "object"
        },
        "policy_number": {
          "type": "string"
        },
        "state": {
          "enum": [
            "bound",
            "cancelled"
          ],
          "type": "string"
        }
      },
      "type": "object"
    },
    "payment_setup": {
      "additionalProperties": false,
      "properties": {
        "environment": {
          "enum": [
            "test",
            "live"
          ],
          "type": "string"
        },
        "payment_method_types": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "provider": {
          "type": "string"
        },
        "setup_intent_id": {
          "type": "string"
        },
        "usage": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "agent_instructions": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "service_requests": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "action_summary": {
            "type": "string"
          },
          "billing_effect": {
            "type": "string"
          },
          "carrier_conditions": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "coverage_effect": {
            "type": "string"
          },
          "details": {
            "type": "string"
          },
          "estimated_refund_status": {
            "enum": [
              "not_applicable",
              "unknown_pending_review"
            ],
            "type": "string"
          },
          "final_outcome": {
            "additionalProperties": true,
            "description": "Final carrier or billing outcome once Coverage Cat can confirm it.",
            "type": "object"
          },
          "reason": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "request_type": {
            "enum": [
              "policy_cancellation",
              "refund_request",
              "support_case"
            ],
            "type": "string"
          },
          "requested_at": {
            "format": "date-time",
            "type": "string"
          },
          "requested_effective_date": {
            "format": "date",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending_review",
              "completed"
            ],
            "type": "string"
          },
          "uncertainty": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "missing_fields": {
      "description": "Structured missing-value hints for homeowners pre-submit review.",
      "items": {
        "additionalProperties": true,
        "description": "Structured missing-value hints for homeowners pre-submit review.",
        "type": "object"
      },
      "type": "array"
    },
    "application_submitted": {
      "type": "boolean"
    },
    "payment_url": {
      "description": "Coverage Cat browser URL for secure payment fallback.",
      "format": "uri",
      "type": "string"
    },
    "review_items": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "type": "string"
          },
          "display_value": {
            "type": "string"
          },
          "enum": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "label": {
            "type": "string"
          },
          "number": {
            "type": "integer"
          },
          "path": {
            "items": {
              "type": [
                "string",
                "integer"
              ]
            },
            "type": "array"
          },
          "suggested_value": {}
        },
        "type": "object"
      },
      "type": "array"
    },
    "verification": {
      "additionalProperties": false,
      "properties": {
        "instructions": {
          "type": "string"
        },
        "request_tool": {
          "type": "string"
        },
        "required": {
          "type": "boolean"
        },
        "retry_after_seconds": {
          "minimum": 0,
          "type": "integer"
        },
        "status": {
          "enum": [
            "required",
            "pending",
            "verified",
            "not_required"
          ],
          "type": "string"
        },
        "status_tool": {
          "type": "string"
        }
      },
      "required": [
        "status",
        "required",
        "retry_after_seconds",
        "request_tool",
        "status_tool",
        "instructions"
      ],
      "type": "object"
    },
    "intake_access_token": {
      "description": "Short-lived follow-up bearer. On REST, send it back as Authorization for the next `/api/intake/{uid}` call. On MCP, retry the same follow-up tool with this token only when your host cannot preserve Coverage Cat's hidden shopper session. Never display it to the shopper.",
      "type": "string"
    }
  },
  "required": [
    "uid",
    "status"
  ],
  "type": "object"
}