Create, update, submit, or poll a delegated homeowners intake in a single operator-authenticated loop.
Use this endpoint as the primary operator-side enrichment loop for delegated homeowners purchase. Omit uid to create a new intake. Reuse the returned uid on every follow-up call. Start with the fullest intake patch you can assemble from approved operator-side context, and for any non-user-confirmed home value include matching intake.home[].field_estimates metadata. Treat credit_check_authorized as the real homeowner's explicit authorization for Coverage Cat's soft credit pull on the assembled application. If the operator already collected that exact consent separately, a complete first create call may include credit_check_authorized: true. Otherwise hold it back until the homeowner has reviewed the assembled application and explicitly authorized the soft credit pull. If the only remaining missing_fields entry is credit_check_authorized, render that one-time review step from your current application summary, then resend the same uid with credit_check_authorized: true. Do not break the intended second turn into a standalone current-policy-expiration question; if policy_expire is the remaining review gap, Coverage Cat can carry an estimated policy_expire value two months from today into that same review step. If status is needs_more_info, keep filling the returned missing_fields behind the scenes from your own systems first and only escalate to the human after approved context is exhausted. When Coverage Cat returns homeowner_fix_issues_request_login_url, share that safe sign-in request page if you want the homeowner to complete the remaining items in Coverage Cat's GUI. If status is pending_quotes, poll this same endpoint with the same uid. If status is quoted, summarize the returned offers and optionally share homeowner_quotes_request_login_url, where the homeowner can request their own login link before reviewing any unconfirmed estimated home answers and finishing bind in Coverage Cat's consumer portal. Set sandbox: true only on the first create call when you want mocked delegated homeowners test data instead of live customer email or carrier traffic.
Request
- Base URL: https://api.coveragecat.com
- URL: https://api.coveragecat.com/api/agent/homeowners/quotes
- Auth: HTTP bearer
Headers
Optional explicit Coverage Cat API version selector. Omit the header to use the current stable version.
Optional idempotency key for consumer or operator write requests. Coverage Cat replays the cached successful response for the same subject, path, and key for 24 hours, and rejects a changed payload under the same key.
Request body
Response
Current delegated homeowners state.
Changes
No recorded changes to this operation across all 1 revision of this API.