GET /api/v1/context/roofing — Materials and Labor

The roofing context endpoint returns manufacturer-backed shingle and roofing material specifications alongside optional BLS regional labor rates for roofing contractors (SOC 47-2181). Material records include structural and performance specs — warranty years, wind rating, fire class, and UL impact rating class — which are commonly used to match products to insurance requirements and incentive programs. Pass include_labor=true to receive the BLS labor context in the same response, avoiding a second API call when building a roofing quote. Endpoint

GET https://homeservicedata.org/api/v1/context/roofing

Query Parameters

string

Filter by manufacturer name. Partial match, case-insensitive (e.g., GAF, Owens Corning).

string

Filter by material type. Partial match, case-insensitive (e.g., asphalt_shingle, metal, tile).

integer

Filter by UL 2218 impact resistance class. One of: 1, 2, 3, 4. Class 4 is the highest impact resistance.

boolean

When true, returns only material records verified for quote use.

boolean

default:"false"

When true, the response includes a labor array of BLS regional labor rate records for roofing contractors (SOC 47-2181).

string

Two-letter state code. Only used when include_labor=true to scope labor results to a state.

boolean

default:"false"

When true and include_labor=true, state-level labor records are included alongside metro records.

integer

default:"100"

Maximum number of material records to return. Capped at 500. Labor results are always capped at 100.

Response Fields

array

Array of roofing material context objects.

Show Material record fields

string

Unique record identifier.

string | null

Internal product identifier if matched to the product catalog.

string

Manufacturer name.

string | null

Product line or series name (e.g., Timberline HDZ, Duration).

string

Material category (e.g., asphalt_shingle, metal_standing_seam, clay_tile).

object

Technical specifications for the product.

Show specs fields

integer | null

Manufacturer warranty period in years.

integer | null

Rated wind resistance in mph (per ASTM D3161/D7158).

string | null

UL fire resistance class: A, B, C, or unrated.

integer | null

UL 2218 impact resistance class (1–4).

number | null

Standard weather exposure in inches.

number | null

Number of bundles per roofing square (100 sq ft).

integer | null

Weight per roofing square in pounds.

integer | null

Algae-resistance warranty period in years, if applicable.

boolean

Whether this record is cleared for customer-facing quote use.

string | null

Confidence tier: high, medium, or low.

object

Source traceability.

Show provenance fields

string | null

Internal source document reference.

string | null

URL to the manufacturer product page or spec sheet.

string | null

ISO 8601 timestamp of last verification.

string

Always roofing_material_context.

array | null

BLS regional labor rate records for roofing (SOC 47-2181). Only present when include_labor=true. Structure mirrors the /api/v1/context/labor response records. See the Labor context reference for full field descriptions.

object

Query summary metadata.

Show Coverage fields

integer

Number of material records returned.

integer

Number of labor records returned (0 if include_labor was not set).

boolean

Whether material results were restricted to quote-safe records.

string

Description of the trust model for this dataset.

Class 4 impact-rated shingles (impact_rating_class=4) often qualify for homeowner insurance discounts. Surfacing this spec in a quote can strengthen close rates in hail-prone markets.

Example Request

curl -G https://homeservicedata.org/api/v1/context/roofing \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "manufacturer=GAF" \
  --data-urlencode "impact_rating_class=4" \
  --data-urlencode "quote_safe=true" \
  --data-urlencode "limit=5"

curl -G https://homeservicedata.org/api/v1/context/roofing \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "manufacturer=GAF" \
  --data-urlencode "include_labor=true" \
  --data-urlencode "state=TX" \
  --data-urlencode "limit=5"

Example Response

{
  "success": true,
  "data": {
    "materials": [
      {
        "record_id": "rfg_01hzka1bc2de3fg4hi5jk6cdef",
        "product_id": "prd_01hzka1bc2de3fg4hi5gaf001",
        "manufacturer": "GAF",
        "product_line": "Timberline HDZ",
        "material_type": "asphalt_shingle",
        "specs": {
          "warranty_years": 30,
          "wind_rating_mph": 130,
          "fire_class": "A",
          "impact_rating_class": 4,
          "exposure_inches": 5.625,
          "bundles_per_square": 3,
          "weight_per_square_lbs": 240,
          "algae_resistance_years": 25
        },
        "quote_safe": true,
        "confidence": "high",
        "provenance": {
          "source_document_id": "doc_01hzka1bc2de3fg4hi5gafhdz",
          "source_url": "https://www.gaf.com/en-us/roofing-products/residential-roofing/shingles/timberline-hdz",
          "last_verified_at": "2024-10-01T00:00:00Z",
          "trust_basis": "roofing_material_context"
        }
      }
    ],
    "labor": null,
    "coverage": {
      "material_records_returned": 1,
      "labor_records_returned": 0,
      "quote_safe_only": true,
      "trust_basis": "Roofing material context is manufacturer-page backed. Roofing labor returns BLS rows when SOC 47-2181 has been loaded."
    }
  }
}

Overview

Search & Catalog

Finance

Equipment & Hardware

Context Datasets

Composite

Sync

GET /api/v1/context/roofing — Materials and Labor

Query Parameters

Response Fields

Example Request

Example Response

​Query Parameters

​Response Fields

​Example Request

​Example Response

Query Parameters

Response Fields

Example Request

Example Response