Create Quote

Runs carrier quotes asynchronously. Poll results via Quote Status.

Creates a quote request and dispatches carrier quote jobs to the quotes queue.

Each carrier quote runs asynchronously. Poll results in Quote Status.

Endpoint

POST /api/v1/quote/request

Example Request body

{
  "product_code": "required string",
  "assigned_producer_email": "required string (email)",
  "form_types": ["optional array of strings like ho3, dp3"],
  "carrier_keys": ["optional array of carrier code/name"],
  "fields": {
    "first_name": "required",
    "last_name": "required",
    "insured_email": "required",
    "insured_date_of_birth": "required",
    "insured_phone": "required",
    "phone_type": "required option",
    "ownership": "required option",
    "effective_date": "required",
    "occupancy": "required option",
    "dwelling_a": "required",
    "roof_year": "required",
    "roof_option": "required option",
    "roof_shape": "required option",
    "square_feet": "required",
    "year_built": "required",
    "protection_class": "required option",
    "construction_type_options": "required option",
    "dwelling_type": "required option",
    "usage": "required option",
    "house_number": "required",
    "street": "required",
    "city": "required",
    "county": "required",
    "state": "required",
    "zipcode": "required",
  }
}

Notes

• assigned_producer_email is required and must belong to the team.

• product_code is required, see List Products for product codes.

• If form_types is missing, all form types for the product are used. See List Products for available form types per product.

• If carrier_keys is missing, all appointed carriers are used. See List Carriers for full list of carrier codes to pass.

• The request body example only shows required fields. Additional fields are supported.

• For allowed fields and option values, see Quote request fields.

Response (200)

{
  "quote_request_id": "string",
  "quote_url": "https://api.askfetch.com/api/v1/quote/{{quote_request_id}}",
  "fetch_quote_id": "string",
  "counts": {
    "processing": 4,
    "success": 0,
    "error": 0
  },
  "rate_index": [
    {
      "id": "rate_id",
      "rate_url": "https://api.askfetch.com/api/v1/rate/{{rate_id}}",
      "status": "processing",
      "carrier": "Frontline",
      "carrier_key": "frontline",
      "form_type": "HO3"
    }
  ],
  "unresolved_carrier_keys": [],
  "unresolved_form_types": []
}