A completed order gives you the same measurements three ways: printed on a white-labeled PDF, returned as JSON on the order, and as the raw XML the PDF was rendered from. This guide goes through what is in there and who uses which part. Open the sample report in another tab and follow along.
What is on the first three pages?
The pages a sales rep shows a homeowner. The cover carries the property address, your company name, logo and contact block, a roof diagram, a table of contents and the headline measurements. Page two is the aerial map of the property. Page three is the report summary with the waste calculation. Everything after that is for whoever is pricing the job.
What diagrams are included?
Four drawings, each available for the whole property and for each structure separately, on the PDF and from the diagrams endpoint as SVG or PNG:
- Outline. The roof plan: facets and edges, unlabelled.
- Area. Each facet labelled with its area in square feet.
- Pitch. Each facet labelled with its pitch, in twelfths.
- Lengths. Every edge colour-coded by type and labelled with its true sloped length, with a legend.
What do the measurement tables contain?
The normalized data the API returns, under the same names, for each structure and for the property as a whole. The field reference is under report data.
| Table | API field | Used for |
|---|---|---|
| Area and squares | totalAreaSqFt, totalSquares | Shingle, membrane and underlayment quantities |
| Area by pitch | pitchAreas | Steep-slope labour pricing, safety planning |
| Edge lengths by type | edgeTotals | Drip edge, starter, cap, flashing, ice and water shield |
| Hips and ridges | hipsAndRidgesLengthFt | Ridge cap and ridge vent |
| Facet list | faces[] | Per-plane area, pitch and edges, for solar layout and waste |
| Attic estimate | estimatedAtticSqFt | Ventilation and insulation sizing |
Edge categories are always all ten, zero-filled: eave, rake, ridge, hip, valley, step flashing, wall flashing, parapet, bend and other. The glossary defines each.
How are multiple buildings handled?
As separate structures. A property with a house, a detached garage and a shed comes back
with three entries in structures[], ordered by roof area, each with the full set
of fields and its own diagrams. totals is the sum. Price the garage separately,
or leave it out, without a second order.
Who uses which part?
- Roofing contractors price from squares, pitch areas, and the eave, rake, hip, ridge and valley lengths.
- Insurance adjusters take the ESX into Xactimate and use the PDF as the file document.
- Solar designers work from the per-facet list: area and pitch per plane.
- Software companies parse the JSON on the webhook and never open the PDF, then hand the branded PDF link to their own users.
What is not in a roof measurement report?
Condition. A measurement report describes geometry. It does not assess materials, damage or remaining life, and it does not include a site visit. It is the measured roof, so that the person who does visit, or the software that never does, is working from the right numbers.
Frequently asked questions
What formats does a RoofQuery report come in?
A white-labeled PDF, the raw XML, an Xactimate ESX, and four diagrams as SVG or PNG. All are included in the one report price.
Does the report include a detached garage?
If you order with a scope that includes it. Each building comes back as its own structure with its own totals and diagrams, plus a combined total.
Does a roof measurement report show damage?
No. It measures geometry: areas, pitches and edge lengths. Condition and damage are assessed separately.