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.

post/api/agent/homeowners/quotes

Request

  • Base URL: https://api.coveragecat.com
  • URL: https://api.coveragecat.com/api/agent/homeowners/quotes
  • Auth: HTTP bearer

Headers

Coverage-Cat-API-Version'v1'

Optional explicit Coverage Cat API version selector. Omit the header to use the current stable version.

Idempotency-Keystring

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

sandboxboolean

Optional mocked-mode flag for delegated homeowners testing. Set this to true only when creating a brand-new delegated homeowners session. The sandbox flag sticks to that uid, reuses the real validation and one-time review/credit-consent checkpoint, skips live customer emails and carrier traffic, returns pending_quotes after the first successful submit, and returns mocked homeowners offers on a later poll of the same uid.

uidstring

Existing delegated homeowners intake identifier. Omit to create a new intake.

Response

Current delegated homeowners state.

agent_instructionsstring[]
homeowner_fix_issues_request_login_urlstring uri

Safe homeowner-facing sign-in request page for the fix-issues flow. Coverage Cat returns this while the delegated intake still needs more information and you want the homeowner to complete those remaining items in Coverage Cat's GUI.

homeowner_portal_urlstring uri

Secure Coverage Cat consumer portal link for this intake. The homeowner uses this portal to review details, choose an offer, confirm any estimated home answers, and complete final bind. Treat this as a sensitive direct session link; if you need a safer pass-through URL, use homeowner_quotes_request_login_url.

homeowner_quotes_request_login_urlstring uri

Safe homeowner-facing sign-in request page for the offers view. Share this with the homeowner when you need them to reach their offers page without handing over an operator or direct OTP login link.

job_idstring

Stable delegated-homeowners async job identifier. Reuses the intake uid.

known_summaryobject

Current delegated homeowners intake summary. This may include PII such as applicant name, applicant email, and full insured-property addresses. It may also include a homes[].field_estimates[] array per home listing values that were estimated by either the operator or Coverage Cat. Delegated quoting may proceed with these estimates, but unconfirmed estimated home fields are sent back through the homeowner review flow before final bind completes in Coverage Cat's consumer portal. Do not treat this object as safe-to-log telemetry.

offers_page_urlstring uri

Backwards-compatible alias for homeowner_portal_url.

operator_dashboard_urlstring uri

Short-lived browser login link for the operator homeowners dashboard, usually prefiltered to this intake UID.

poll_after_secondsinteger

Suggested minimum wait before polling again.

poll_requestobject

Structured POST request reference for polling the same delegated homeowners uid.

response_summarystring
sandboxboolean

True when this delegated homeowners response is mocked sandbox data.

schemaobject
status'needs_more_info' | 'pending_quotes' | 'quoted'
status_endpointobject

Structured status polling reference for the async job.

status_urlstring uri

GET endpoint returning coarse non-PII status rows for this delegated homeowners request.

uidstring

Changes

No recorded changes to this operation across all 1 revision of this API.