# Lead Value - Roof

The **Lead Value - Roof API** is a fast, reliable tool for instantly assigning a value to roof replacement leads by calculating the approximate roof area and replacement costs based solely on a property address. Built specifically for roofing contractors, home improvement platforms, and sales engagement tools, it supports top-of-funnel lead generation and enables sales teams to quickly assess project value and prioritize opportunities.

The API processes address-level inputs and optional parameters like roof material and installation pricing per square — to return a detailed approximation that includes roof area (adjusted for pitch), average pitch angle, complexity level, and total estimated replacement cost.

The **Lead Value - Roof API** is designed to deliver consistent, data-backed approximations in real time — not to replace on-site inspections, precise measurements, or detailed proposals. Instead, it equips sales teams with a scalable, automated way to qualify and value leads.  By providing relative cost estimates early in the sales cycle, businesses can increase quote-to-close rates, reduce time spent on manual assessments, and focus efforts on the highest-value opportunities.

**Note:** If any parameter in the response contains a `null` value, it indicates that the value could not be determined based on the provided data.

**Structure Present Confidence Score Values**

| Value | Description |
|-------|-------------|
| null  | Value could not be determined. |
| 100   | High confidence that rooftop data corresponds to the primary structure at the exact address provided. |
| 50    | Data may correspond to a nearby structure rather than the actual address, indicating a possible issue with the input address. |

<br>

**When a Score of 50 is Returned**

A confidence score of 50 may be returned under the following conditions:

- No structure exists at the provided address (e.g., empty lot, typo in house number, or unvalidated address).
- Our system interpolated coordinates to the closest known structure due to an invalid or unrecognized address.
- Our system failed to detect a structure due to:
  - Recent new construction not yet reflected in mapping data
  - Street name formatting issues (e.g., uncommon abbreviations or casing)
  - Address formatting discrepancies that prevented structure identification

In such cases, the rooftop data returned may not represent the structure located at the submitted address.

**Data Accuracy Alerts**

The `Roof Pitch Alert` and `Roof Area Alert` parameters help identify potentially unreliable or atypical measurement results related to roof pitch or area. These alerts are designed to prompt additional validation or inspection.

**Roof Pitch Alert Values**

Indicates potential issues with roof pitch estimation.

| Value      | Description                                                                  |
|------------|------------------------------------------------------------------------------|
| null       | Value could not be determined.                                               |
| NO_ALERTS  | No pitch-related alerts detected.                                            |
| LOW_PITCH  | Detected pitch is unusually low — possibly due to flat roofs or obstruction. |
| HIGH_PITCH | Detected pitch is unusually high — may indicate steep or complex geometry.   |

<br>

**Roof Area Alert Values**

Indicates potential issues with roof area estimation.

| Value      | Description                                                                 |
|------------|-----------------------------------------------------------------------------|
| null       | Value could not be determined.                                              |
| NO_ALERTS  | No area-related alerts detected.                                            |
| LOW_AREA   | Estimated area is smaller than expected — may be caused by occlusion or missing imagery. |
| HIGH_AREA  | Estimated area is larger than expected — could result from multiple structures or over-segmentation. |

<br>

**When Alerts Are Triggered**

Alerts are generated to assist in identifying potentially inaccurate or atypical results based on the roof pitch or area. Common scenarios include:

- **Obstructed View**: Tree canopy, overhangs, or neighboring structures may obscure full visibility of the rooftop.
- **Imagery Quality**: Satellite or aerial images may be affected by shadows, poor lighting, or resolution issues.
- **Roof Complexity**: Irregular or highly complex roof geometries can make measurement modeling less reliable.
- **Multiple Structures**: Properties with multiple buildings or large accessory structures may lead to elevated or ambiguous area calculations.
- **Partial or Missing Imagery**: Incomplete or outdated imagery data can lead to pitch or area deviations.

In such cases, alerts provide a useful prompt for further validation, helping to prioritize follow-up review and ensure more accurate project planning.

## Get Lead Value - Roof

 - [GET /api/v1/roof-estimate](https://docs.quantiv.io/api/openapi/lead-value-roof/paths/~1api~1v1~1roof-estimate/get.md)