Skip to main content
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.com/api/v1/context/roofing

​
Query Parameters

​
manufacturer
string
Filter by manufacturer name. Partial match, case-insensitive (e.g., GAF, Owens Corning).
​
material_type
string
Filter by material type. Partial match, case-insensitive (e.g., asphalt_shingle, metal, tile).
​
impact_rating_class
integer
Filter by UL 2218 impact resistance class. One of: 1, 2, 3, 4. Class 4 is the highest impact resistance.
​
quote_safe
boolean
When true, returns only material records verified for quote use.
​
include_labor
boolean
default:"false"
When true, the response includes a labor array of BLS regional labor rate records for roofing contractors (SOC 47-2181).
​
state
string
Two-letter state code. Only used when include_labor=true to scope labor results to a state.
​
include_states
boolean
default:"false"
When true and include_labor=true, state-level labor records are included alongside metro records.
​
limit
integer
default:"100"
Maximum number of material records to return. Capped at 500. Labor results are always capped at 100.

​
Response Fields

​
materials
array
Array of roofing material context objects.
​
labor
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.
​
coverage
object
Query summary metadata.
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.com/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"

​
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."
    }
  }
}