Retrieve UK/US input requirements or labelled reference examples when specifically requested. For a project budget, vague cost question or drawings, use calculate_building_work. Reference examples are not the user's project price. No account or drawing-file access.
View input schema
{
"type": "object",
"properties": {
"country": {
"description": "Country pricing policy. Use GB for Great Britain or US for the United States. If omitted, GB is used for backwards compatibility.",
"type": "string",
"enum": [
"GB",
"US"
]
},
"jobType": {
"description": "Residential project type supported by the selected country policy.",
"type": "string",
"enum": [
"Combined project",
"Rear extension",
"Kitchen extension",
"Side extension",
"Wraparound extension",
"Loft conversion",
"Barn conversion",
"Refurbishment",
"Commercial office refurbishment",
"New kitchen",
"New bathroom",
"Office / summerhouse",
"Garage conversion",
"Basement work / conversion",
"Lower-ground floor refurbishment",
"New build",
"home_addition",
"whole_home_remodel",
"kitchen_remodel",
"bathroom_remodel",
"attic_conversion",
"garage_conversion",
"basement_remodel",
"backyard_studio",
"new_home_construction"
]
},
"postcodeArea": {
"description": "GB outward postcode only, for example BS3. Never send a full address.",
"type": "string",
"pattern": "^[A-Z]{1,2}\\d[A-Z\\d]?$"
},
"state": {
"description": "US two-letter state or DC code.",
"type": "string",
"enum": [
"CT",
"ME",
"MA",
"NH",
"RI",
"VT",
"NJ",
"NY",
"PA",
"IN",
"IL",
"MI",
"OH",
"WI",
"IA",
"KS",
"MN",
"MO",
"NE",
"ND",
"SD",
"DE",
"DC",
"FL",
"GA",
"MD",
"NC",
"SC",
"VA",
"WV",
"AL",
"KY",
"MS",
"TN",
"AR",
"LA",
"OK",
"TX",
"AZ",
"CO",
"ID",
"MT",
"NV",
"NM",
"UT",
"WY",
"CA",
"OR",
"WA",
"AK",
"HI"
]
},
"zipCode": {
"description": "Optional US five-digit ZIP code. Never send a street address.",
"type": "string",
"pattern": "^\\d{5}$"
},
"scope": {
"default": {},
"type": "object",
"properties": {
"vatTreatment": {
"type": "string",
"enum": [
"unconfirmed",
"standard_20",
"qualifying_conversion_5",
"qualifying_empty_home_5",
"qualifying_new_dwelling_0",
"mixed"
],
"description": "Supplier-confirmed VAT treatment of the priced construction scope. Never infer zero/reduced rating from a project label or registration. Mixed-rate work stays unconfirmed until split; separate fees/goods may differ."
},
"approximateSize": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 15000,
"description": "Project floor area. Defaults to square feet for US work; set areaUnit when the user supplied square metres."
},
"finishBand": {
"type": "string",
"enum": [
"Builder grade",
"Good domestic",
"Premium domestic"
],
"description": "Finish specification: Builder grade is budget, Good domestic is a normal quality domestic finish, and Premium domestic is higher specification."
},
"scopeBand": {
"type": "string",
"enum": [
"Lean",
"Balanced",
"Expanded"
],
"description": "Breadth of work: Lean is a reduced scope, Balanced is a normal complete scope, and Expanded is a broader scope. This is not a confidence or risk setting."
},
"urgencyBand": {
"type": "string",
"enum": [
"Flexible",
"Soon",
"Urgent"
]
},
"availability": {
"type": "string",
"enum": [
"Ready now",
"2–4 weeks",
"1–2 months",
"3+ months",
"6+ months",
"Next year"
]
},
"combinedPrimaryJobType": {
"type": "string",
"enum": [
"Rear extension",
"Kitchen extension",
"Side extension",
"Wraparound extension",
"Loft conversion",
"Barn conversion",
"Refurbishment",
"Office / summerhouse",
"Garage conversion",
"Basement work / conversion",
"New build"
]
},
"combinedAdditionalJobType": {
"type": "string",
"enum": [
"Rear extension",
"Kitchen extension",
"Side extension",
"Wraparound extension",
"Loft conversion",
"Barn conversion",
"Refurbishment",
"Office / summerhouse",
"Garage conversion",
"Basement work / conversion",
"New build"
]
},
"combinedAdditionalSize": {
"type": "number",
"minimum": 0
},
"refurbishmentPackages": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"enum": [
"Plastering",
"Painting & decorating",
"Wood / laminate flooring",
"Kitchen work",
"Bathroom work",
"Windows / doors / glazing",
"External walls / insulation",
"General building / making good"
]
}
},
"additionalInternalWorkPackages": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"enum": [
"Plastering",
"Painting & decorating",
"Wood / laminate flooring",
"Kitchen work",
"Bathroom work",
"Windows / doors / glazing",
"External walls / insulation",
"General building / making good"
]
},
"description": "Packages in existing rooms outside the main extension or loft. Kitchen work and Bathroom work use kitchenScope and bathroomScope to define the same room allowance and are counted once."
},
"structuralSteelLikely": {
"type": "boolean"
},
"complexGroundworks": {
"type": "boolean"
},
"accessIssues": {
"type": "boolean"
},
"planningStageOnly": {
"type": "boolean"
},
"includesBasementWork": {
"type": "boolean"
},
"basementBathroomIncluded": {
"type": "boolean"
},
"basementUtilityIncluded": {
"type": "boolean"
},
"includesLowerGroundWork": {
"type": "boolean"
},
"includesAdditionalInternalWorks": {
"type": "boolean",
"description": "True only when the project also changes existing internal rooms outside the main extension or loft."
},
"commercialFurnitureIncluded": {
"type": "boolean"
},
"propertyForm": {
"type": "string",
"enum": [
"Flat",
"Maisonette",
"Terraced house",
"Semi-detached house",
"Detached house",
"Barn / agricultural building",
"Other / not sure",
"Commercial office",
"Office suite"
],
"description": "Existing property type. Use only the user's answer; do not infer it from the project type."
},
"propertyPeriod": {
"type": "string",
"enum": [
"Not sure",
"Modern / new build",
"1970s-1990s",
"1950s-1960s",
"1930s-1940s",
"Victorian / Edwardian",
"Older / period property",
"Listed / heritage"
]
},
"barnStructureType": {
"type": "string",
"enum": [
"Not sure",
"Traditional timber / oak frame",
"Steel portal frame",
"Stone / brick load-bearing walls",
"Mixed structure"
]
},
"kitchenScope": {
"type": "string",
"enum": [
"No kitchen work",
"Kitchen allowance",
"New kitchen: supply and install",
"New kitchen: install only",
"Client-supplied kitchen, builder prepares room",
"Kitchen / diner works"
],
"description": "Kitchen work included anywhere in this project. If Kitchen work is also selected as an additional internal package, this scope defines that same kitchen allowance; do not describe it as a second kitchen."
},
"bathroomScope": {
"type": "string",
"enum": [
"No bathroom work",
"Bathroom allowance",
"New bathroom: supply and install",
"New bathroom: install only",
"Ensuite / shower room",
"WC / cloakroom"
],
"description": "Bathroom work included anywhere in this project. If Bathroom work is also selected as an additional internal package, this scope defines that same bathroom allowance; do not describe it as a second bathroom."
},
"refurbishmentScope": {
"type": "string",
"enum": [
"General refurbishment",
"Mixed room upgrade",
"Decoration only",
"External walls / insulation",
"Windows / doors / glazing",
"Kitchen works",
"Bathroom works",
"Kitchen and bathroom works",
"Whole property refurbishment"
]
},
"refurbishmentRoomState": {
"type": "string",
"enum": [
"Empty",
"Partly furnished",
"Occupied"
]
},
"refurbishmentCondition": {
"type": "string",
"enum": [
"Good",
"Average",
"Poor",
"Damp / cracks / problematic"
]
},
"refurbishmentPrepLevel": {
"type": "string",
"enum": [
"Simple refresh",
"Normal prep",
"Heavy prep"
]
},
"commercialBuildingAccess": {
"type": "string",
"enum": [
"Standalone / direct street access",
"Shared building, straightforward access",
"Managed building / booked access",
"Constrained central-London access"
]
},
"commercialFloorAccess": {
"type": "string",
"enum": [
"Ground / first floor",
"Upper floors with goods lift",
"Upper floors with passenger lift only",
"Upper floors by stairs only",
"Multiple floors"
]
},
"commercialOccupancy": {
"type": "string",
"enum": [
"Vacant during works",
"Phased / partly occupied",
"Fully occupied live office",
"Out-of-hours works only"
]
},
"commercialLandlordStatus": {
"type": "string",
"enum": [
"Approval confirmed / not needed",
"Licence to alter in progress",
"Approval not started",
"Not sure"
]
},
"commercialAsbestosStatus": {
"type": "string",
"enum": [
"Refurbishment survey clear",
"Management survey only",
"Survey required / not confirmed",
"Known asbestos constraints"
]
},
"commercialPartitionsScope": {
"type": "string",
"enum": [
"Retain layout / minor making good",
"Some partitions and ceiling alterations",
"Extensive partitions and suspended ceilings"
]
},
"commercialElectricalScope": {
"type": "string",
"enum": [
"Retain existing / minor electrical works",
"Lighting and small-power alterations",
"New lighting, power and floor-box layout"
]
},
"commercialDataScope": {
"type": "string",
"enum": [
"No data / comms work",
"Data points and Wi-Fi alterations",
"New structured cabling, Wi-Fi and comms cabinet"
]
},
"commercialHvacScope": {
"type": "string",
"enum": [
"Retain existing HVAC",
"Alter existing AC / ventilation",
"New or substantially replaced HVAC"
]
},
"commercialFireSecurityScope": {
"type": "string",
"enum": [
"Existing systems retained",
"Fire-safety alterations and interfaces",
"Fire, access control, intercom and security package"
]
},
"basementScope": {
"type": "string",
"enum": [
"Existing basement refurbishment",
"Existing cellar conversion",
"Lower / enlarge existing cellar",
"New basement beneath extension",
"New basement beneath existing house"
]
},
"basementIntendedUse": {
"type": "string",
"enum": [
"Storage / utility",
"Habitable room(s)",
"Bedroom / bathroom accommodation",
"Kitchen / living accommodation",
"Separate dwelling / unit"
]
},
"basementHeadroom": {
"type": "string",
"enum": [
"No floor lowering",
"Minor lowering up to 300 mm",
"Lowering 300-600 mm",
"Major lowering over 600 mm",
"Not confirmed"
]
},
"basementStructuralSupport": {
"type": "string",
"enum": [
"No underpinning expected",
"Local structural support",
"Sequential underpinning",
"Piled / engineered support",
"Not confirmed"
]
},
"basementWaterproofing": {
"type": "string",
"enum": [
"Existing dry system retained",
"Local repairs / upgrades",
"Full tanking system",
"Cavity-drain membrane and pumps",
"Not confirmed"
]
},
"basementGroundwater": {
"type": "string",
"enum": [
"No known issue",
"Possible / high water table",
"Known groundwater / water ingress",
"Not confirmed"
]
},
"basementAccess": {
"type": "string",
"enum": [
"Direct external access",
"Restricted side / rear access",
"Removal through house",
"Highly constrained urban access"
]
},
"basementOccupancy": {
"type": "string",
"enum": [
"Vacant during works",
"House occupied during works"
]
},
"basementStairScope": {
"type": "string",
"enum": [
"Existing stair retained",
"Alter existing stair / opening",
"New basement staircase"
]
},
"basementDrainageScope": {
"type": "string",
"enum": [
"Existing gravity drainage retained",
"Drainage alterations",
"Pumped drainage required",
"Not confirmed"
]
},
"lowerGroundScope": {
"type": "string",
"enum": [
"Refresh existing finished rooms",
"Refurbish existing habitable floor",
"Convert existing ancillary / storage rooms"
]
},
"lowerGroundUse": {
"type": "string",
"enum": [
"Part of the main home",
"Dependent annexe",
"Separate dwelling / unit"
]
},
"lowerGroundExposure": {
"type": "string",
"enum": [
"Mostly above ground",
"Split-level / partly below ground",
"Mostly below ground"
]
},
"lowerGroundMoisture": {
"type": "string",
"enum": [
"Dry / no known issue",
"Local damp repairs",
"Known damp / waterproofing work",
"Not confirmed"
]
},
"lowerGroundDaylight": {
"type": "string",
"enum": [
"Existing windows retained",
"Alter or enlarge openings",
"New lightwell / external excavation",
"Not confirmed"
]
},
"lowerGroundServices": {
"type": "string",
"enum": [
"Existing services retained",
"Alter existing services",
"New kitchen / bathroom services",
"Independent services / meters"
]
},
"lowerGroundAccess": {
"type": "string",
"enum": [
"Direct external access",
"Access through main home",
"Constrained access"
]
},
"lowerGroundOccupancy": {
"type": "string",
"enum": [
"Vacant during works",
"House occupied during works"
]
},
"bedroomCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"roomCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"windowCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"doorCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"externalWallArea": {
"type": "number",
"minimum": 0
},
"additionalInternalWorksArea": {
"type": "number",
"minimum": 0,
"description": "Total floor area of existing rooms affected outside the main extension or loft, in the supplied area unit."
},
"commercialWashroomCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"commercialKitchenetteCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"commercialWorkstationCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"basementArea": {
"type": "number",
"minimum": 0
},
"basementLightwellCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"lowerGroundArea": {
"type": "number",
"minimum": 0
},
"refurbishmentPlasteringArea": {
"type": "number",
"minimum": 0
},
"refurbishmentDecoratingArea": {
"type": "number",
"minimum": 0
},
"refurbishmentFlooringArea": {
"type": "number",
"minimum": 0
},
"decoratingDoorCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"decoratingWindowCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"parkingSpaces": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"areaUnit": {
"type": "string",
"enum": [
"sq_m",
"sq m",
"m2",
"m^2",
"m²",
"sqm",
"square_metres",
"square_meters",
"square metres",
"square meters",
"sq_ft",
"sq ft",
"ft2",
"ft^2",
"ft²",
"sqft",
"sf",
"square_feet",
"square feet"
],
"description": "Unit for approximateSize. GB defaults to sq_m and US defaults to sq_ft. Common m2 and ft2 forms are accepted."
},
"finishLevel": {
"type": "string",
"enum": [
"builder_grade",
"standard",
"premium"
]
},
"scopeLevel": {
"type": "string",
"enum": [
"defined",
"typical",
"expanded"
]
},
"access": {
"type": "string",
"enum": [
"straightforward",
"constrained",
"remote"
]
},
"primaryConstruction": {
"type": "string",
"enum": [
"wood_frame",
"masonry_concrete",
"other_unknown"
]
},
"foundation": {
"type": "string",
"enum": [
"slab",
"crawl_space",
"basement",
"existing_not_applicable"
]
},
"occupiedDuringWork": {
"type": "boolean"
},
"structuralChanges": {
"type": "boolean"
},
"hvacReplacement": {
"type": "boolean"
},
"electricalServiceUpgrade": {
"type": "boolean"
},
"hazardousMaterialRemediation": {
"type": "boolean"
},
"climateCodeRequirements": {
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Country-specific project scope. Use UK fields for GB and US fields for US; do not invent unanswered values."
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}