Roof cost by city
Send a GET request with a state, optional supported city and measured project size.
GET /api/v1/roof-cost?state=TX&city=Dallas&size=2500Use HomeCostGrid’s planning model in your own research.
The first public API release returns transparent state- and city-adjusted project ranges. It is free for light use, rate-limited, and always labeled as a planning estimate—not a quote.
Generic estimate endpoint
Choose a project slug and add planning inputs such as quality, complexity, condition, urgency or permit=false.
GET /api/v1/cost-estimate?project=hvac-replacement-cost&state=FL&city=Miami&size=1800Numbers with context
Responses include the low, expected and high range, labor, materials, permit allowance, contingency, cost per unit, timeline, source date and confidence label.
{
"estimate": {
"currency": "USD",
"low": 11800,
"expected": 14500,
"high": 17900
},
"model": {
"confidenceLabel": "city-adjusted planning model",
"disclaimer": "Planning estimate, not a quote."
}
}57 sourced signals per state
Read the evidence matrix as JSON or CSV. Filter by two-letter state code or topic without generating thin landing pages.
GET /api/public/state-intelligence?state=TX195 decision checks per state
Filter the 9,945 state-control applications by stable ID, state, project, decision area, stage or search term. The five national QA modules are a separate response, not rows in the state-control CSV.
GET /api/public/project-decision-matrix?state=TX&project=roofing&offset=0&limit=250Versions, manifest and fingerprints
Data 2026.08.28.1, schema 1.1.0 and publication 2026.08.28.1 move independently. The checked-in manifest names the schema, record counts, limitations and SHA-256 fingerprints.
GET /api/public/project-decision-matrix?scope=manifestPlain text, BibTeX and CFF
Cite the HomeCostGrid workflow dataset and its data version. For a claim drawn from an agency page, also cite the linked official source. This dataset has no DOI.
GET /api/public/project-decision-matrix?scope=citationSTATE PROJECT MATRIX CONTRACT
One current release, explicit retrieval rules.
The endpoint is read-only and cross-origin accessible. It does not promise immutable historical archives, a DOI or a Creative Commons license.
scopeSmall JSON resourcessummary · freshness · indexing · manifest · versions · citation · national-modulesformatRepresentationsjson · csv · bibtex · cfffiltersState-control selectionid · state · category · project · stage · qpaginationJSON state controlsoffset starts at 0 · limit defaults to 250 · maximum 1,000 · follow nextUrlversionCurrent data release2026.08.28.1; an unavailable version returns 404 with availableVersionserrorsMachine-readable JSONUnknown scope, format, filter or pagination input returns 400; unknown IDs and unavailable versions return 404CSV means 9,945 state controls
The unfiltered CSV contains one header plus exactly 9,945 state-control rows. It never folds in the five national modules. Semantic filters create a complete filtered CSV; offset and limit are JSON-only.
GET /api/public/project-decision-matrix?format=csvFive modules, separate JSON
Use the dedicated scope for the national methodology and quality-assurance modules. A stable module ID may be requested with the id parameter.
GET /api/public/project-decision-matrix?scope=national-modulesRelease validator and fingerprint
Every response exposes a weak release ETag, data, schema and publication version headers, Last-Modified, a canonical/described-by Link, X-Robots-Tag and the logical-dataset SHA-256 fingerprint. The ETag and fingerprint identify the release—not each filtered response body; distribution-specific byte digests live in the manifest.
X-HomeCostGrid-Data-Version: 2026.08.28.1
X-HomeCostGrid-Schema-Version: 1.1.0
X-HomeCostGrid-Publication-Version: 2026.08.28.1Stable ID lookup
State-control IDs combine the lowercase state code, project-family ID and decision-control ID. Text and source maintenance retain an ID; a semantic replacement requires a new ID.
GET /api/public/project-decision-matrix?id=tx.roofing.condition-scopePreferred matrix citation
HomeCostGrid Editorial Desk. (2026). HomeCostGrid State Home Project Decision Matrix (Data version 2026.08.28.1; publication version 2026.08.28.1) [Data set]. HomeCostGrid. https://homecostgrid.com/research/state-project-decision-matrix
- Use Citation File Format or BibTeX when your reference manager supports it.
- Add the stable record ID and question when citing one state-control application.
- Cite the linked official agency separately for source-specific claims.
SUPPORTED PROJECTS
One stable slug per model.
All models use the same location and response contract. Valid size limits and units are returned in validation errors.
roof-replacement-costRoof replacement500–12,000 sq fthvac-replacement-costHVAC replacement400–10,000 sq ftkitchen-remodel-costKitchen remodel50–800 sq ftfoundation-repair-costFoundation repair50–6,000 sq ftdeck-building-costDeck construction80–2,500 sq ftfence-installation-costFence installation25–3,000 linear ftbathroom-remodel-costBathroom remodel20–400 sq ftflooring-installation-costFlooring installation100–12,000 sq ftwindow-replacement-costWindow replacement1–100 windowsinterior-painting-costInterior painting200–15,000 sq ftconcrete-installation-costConcrete installation50–12,000 sq ftFair-use guardrails
- 120 requests per minute per network address in the current public release.
- Cache responses and link back to the methodology when displaying estimates.
- Do not present the output as a contractor quote, appraisal, permit decision or guaranteed market price.
- The project matrix uses HomeCostGrid's custom dataset license: personal, non-commercial research with attribution is permitted; commercial, bulk or republication rights require written permission.
- For bulk access or a commercial data agreement, use the contact form.
