Draft Quote

Update fields on an existing draft quote.

put/v1/agency/draft_quote/{quote_id}

Request

  • Base URL
    https://api.steadily.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.steadily.com/v1/agency/draft_quote/{quote_id}
  • Auth
    HTTP bearer

Path parameters

quote_idstring nullable required

Query parameters

expected_quote_versioninteger nullable

Expected quote revision for a conditional standard quote update.

offer_idstring nullable
policy_idstring nullable

Request body

policy_type'DP1' | 'DP2' | 'DP3' required
effective_datestring date

Effective date in YYYY-MM-DD format. Defaults to today.

quote_idstring required
quote_versioninteger nullable

Version of the quote this update was built from, as returned when the quote was read.

valuation_update_behavior'skip' | 'default'

Controls valuation update behavior.

SKIP: No valuation update DEFAULT: Update if dwelling fields changed; the default for every quote type

SMGA product-version changes refresh every dwelling regardless of this setting.

Example request

{
  "primary_insured": {
    "mailing_address": {
      "street_address": "4825 Mount Sinyala Crossover",
      "city": "Fort Wayne",
      "state": "IN",
      "zip_code": "46808"
    },
    "previous_address": {
      "street_address": "4825 Mount Sinyala Crossover",
      "city": "Fort Wayne",
      "state": "IN",
      "zip_code": "46808"
    }
  },
  "additional_named_insured": [
    {
      "address": {
        "street_address": "4825 Mount Sinyala Crossover",
        "city": "Fort Wayne",
        "state": "IN",
        "zip_code": "46808"
      }
    }
  ],
  "effective_date": "2022-01-15",
  "policy_details": {
    "unique_tracking_id": "id-12345"
  },
  "properties": [
    {
      "property_id": "acf85fa5-4200-4303-96ba-012e546ff628",
      "address": {
        "street_address": "4825 Mount Sinyala Crossover",
        "city": "Fort Wayne",
        "state": "IN",
        "zip_code": "46808",
        "county": "Maricopa",
        "county_fips": "04013",
        "lat": 41.079273,
        "lng": -85.139351
      },
      "property_coverages": [
        {
          "config": [
            {
              "label": "Water Damage Limitation",
              "type": "limit",
              "value": "10%"
            },
            {
              "label": "Water Damage Limitation - Fungi Rot Sublimit",
              "type": "sublimit",
              "value": "5000"
            }
          ],
          "name": "water_damage_limitation"
        }
      ],
      "property_manager": {
        "address": {
          "street_address": "4825 Mount Sinyala Crossover",
          "city": "Fort Wayne",
          "state": "IN",
          "zip_code": "46808"
        }
      },
      "property_details": {
        "heating_sources": [
          "furnace_electric"
        ],
        "has_barred_windows_over_50_percent": "Yes",
        "days_uninsured": 1,
        "builder_name": "Lennar Corp.",
        "fire_protection_class": "9",
        "ca_dic_zone": "ineligible",
        "foundation_type": "concrete_slab",
        "garages": [
          {
            "size": "2",
            "style": "attached_or_built_in"
          }
        ],
        "average_wall_height_feet": 9,
        "bathroom_details": [
          {
            "type": "Full"
          }
        ],
        "bedrooms": 3,
        "fireplaces": 1,
        "finished_basement_percent": 50,
        "kitchens": 1,
        "wind_mitigation": {
          "ibhs_fortified_roof_designation_date": "2024-05-20",
          "inspection_date": "2025-07-01"
        },
        "secondary_construction_type": {
          "percentage": 40
        },
        "secondary_foundation_type": {
          "percentage": 40
        }
      },
      "additional_insured": [
        {
          "loan_number": "JPM98765,12345",
          "address": {
            "street_address": "4825 Mount Sinyala Crossover",
            "city": "Fort Wayne",
            "state": "IN",
            "zip_code": "46808"
          }
        }
      ]
    }
  ],
  "policy_coverages": [
    {
      "config": [
        {
          "label": "Water Damage Limitation",
          "type": "limit",
          "value": "10%"
        },
        {
          "label": "Water Damage Limitation - Fungi Rot Sublimit",
          "type": "sublimit",
          "value": "5000"
        }
      ],
      "name": "water_damage_limitation"
    }
  ],
  "payment": {
    "schedule": "full"
  },
  "quote_id": "qte_100034386",
  "quote_version": 3
}

Response

Successful Response

policy_type'DP1' | 'DP2' | 'DP3' required
effective_datestring date

Effective date in YYYY-MM-DD format. Defaults to today.

agent_ui_urlstring nullable

Direct link to Agent UI, which can be used to complete quote.

carrierstring required
public_policy_idstring nullable required
quote_versioninteger nullable

Version of the quote this response describes. Every saved change creates a new version.

insurance_structure'COI_MASTER_MGA' | 'STANDARD_MGA' | 'XMGA' | 'ARCHIVED'
effective_date_timezonestring nullable
updated_atstring date-time nullable
previous_policy_idstring nullable
renewal_policy_idstring nullable
renewal_quote_idstring nullable
renewal_status'draft' | 'quoted' | 'bound' | 'invalidated'
renewal_start_datestring date nullable
renewal_end_datestring date nullable
quote_idstring required
public_quote_idstring required
status'draft' | 'quoted' | 'declined' | 'bound' | 'issued' required
insurance_score_messagesobject[] nullable

Changes

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added hurricane_or_named_storm_deductible discriminator mapping keys to the /// request property

    • info

      added to the /// request property oneOf list