A property is rarely one roof. There is the house, and then the detached garage, the shed, the pool house, the barn. On a commercial site there might be a main building, a warehouse and a guard hut. A RoofQuery report measures all of them under one order, at one price, as long as they sit on the property at the address you send. This guide is how that works and what the edges are.
What counts as one property?
The address on the order. Send one address and its coordinates, and every building on that property is in scope. A detached garage behind the house is the same property. A duplex on one lot is the same property. The neighbour's garage over the fence is not, and neither is a second site your customer owns across town: a building at a different address is a different order. Fields are in the order reference.
How do I say which structures I want?
With the scope field, which is required and has no default. A wrong default
would be a report that quietly misses the garage a customer wanted priced, so you choose
every time.
| Scope | Measures | Typical use |
|---|---|---|
primary_only | The main building | A storm inspection on the house, a quote for the house alone |
primary_and_garage | The main building and a detached garage | The common residential re-roof |
all_structures | Everything on the property | Full re-roofs, insurance claims, solar, commercial sites |
If you are not sure, order all_structures. It costs the same, and a structure
you did not need is easier to ignore than a structure you did not get.
Does the price change with the number of buildings?
No. A residential report is $13 and a commercial report is $35, whether the property has one roof or six. There is no per-structure surcharge and no size tier. The pricing endpoint returns the same two numbers for every order.
How do multiple structures come back?
As separate entries, plus a combined total. The order carries a structures[]
array with one entry per building, each with the full set of fields: area and squares,
facet count, predominant pitch, area by pitch, the ten edge categories, the per-facet list
and its own four diagrams. totals is the sum across all of them, and
structureCount says how many were measured.
Structures are ordered by roof area, largest first, so structures[0] is the
house and the outbuildings follow. The order is stable: the same report always indexes the
same way, so an index is safe to store or put in a URL. The
report data reference lists every field.
On the PDF, each structure has its own section with its own diagrams and measurement tables, and the summary page carries the property total. The diagram routes address each structure separately as well.
How do I price a garage separately?
Read it from its own entry. Because each building is measured on its own, a contractor can quote the house and the garage as two line items, or offer the garage as an option, from one report. The property total is there when the whole job is one price. Nothing has to be re-ordered to change how it is presented.
Does this apply to commercial properties?
Yes, the same way. A commercial order with all_structures measures every
building on the site at the address, for $35. Flat roofs come back with their parapet walls
as their own edge category, and each building is its own structure with its own totals.
Two of the sandbox test addresses are recorded
multi-structure properties: happy_path_2_structures at 725 Pleasant Ave and
happy_path_4_structures at 401 Garrison St. Order either with a sandbox key
and you get the structures[] shape and the per-structure PDF sections in
about twenty seconds, at no cost.
For what each field in a report means, see what's in a roof measurement report and the glossary.
Frequently asked questions
Does a detached garage cost extra on a roof report?
No. Every structure on the property is included in the one report price, $13 residential or $35 commercial, whatever the count.
Can I get just the house measured?
Yes. Order with scope set to primary_only and only the main building is measured.
Are multiple buildings reported separately or combined?
Both. Each building is its own entry in the structures array with its own totals and diagrams, and the property total is the sum across all of them.
Can one report cover two addresses?
No. A report covers the property at the address you order. A building at a different address is a separate order.