{"openapi":"3.1.0","info":{"title":"Masonry Estimating API","version":"1.0.0","description":"Masonry estimating maths as an API, computed locally and deterministically — the brick, block and mortar counts a bricklayer, builder or estimator works to. The brick endpoint computes how many bricks a wall needs from its area (or length × height in feet): bricks per square foot = 144 / ((brick length + joint) × (brick height + joint)), so a standard modular brick with a 3/8-inch mortar joint works out to the well-known 6.86 bricks per square foot — a 100 ft² wall is 686 bricks, plus a waste allowance and the mortar bags (about 7 per 1000 bricks). The block endpoint does the same for concrete masonry units: a standard 16×8-inch CMU with a 3/8-inch joint is 1.125 blocks per square foot, with roughly 2.5 mortar bags per 100 blocks. Both endpoints take custom unit face dimensions and joint thickness, add a configurable waste percentage and round up to whole units. Everything is computed locally and deterministically, so it is instant and private. Ideal for construction, masonry-contractor, building-supply and home-improvement app developers, takeoff and material-estimating tools, and trade calculators. Pure local computation — no key, no third-party service, instant. Imperial units (inches and square feet). Live, nothing stored. 2 compute endpoints. This is brick/block and mortar estimating; for poured-concrete volume use a concrete API and for drywall use a drywall API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/masonry-api","description":"oanor gateway"}],"tags":[{"name":"Masonry"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/block":{"get":{"operationId":"get_v1_block","tags":["Masonry"],"summary":"Blocks + mortar for a wall","description":"","parameters":[{"name":"area","in":"query","required":false,"description":"Wall area (ft², or use length+height)","schema":{"type":"string"},"example":"320"},{"name":"length","in":"query","required":false,"description":"Wall length (ft)","schema":{"type":"string"}},{"name":"height","in":"query","required":false,"description":"Wall height (ft)","schema":{"type":"string"}},{"name":"block_length","in":"query","required":false,"description":"Block face length (in, default 15.625)","schema":{"type":"string"}},{"name":"block_height","in":"query","required":false,"description":"Block face height (in, default 7.625)","schema":{"type":"string"}},{"name":"joint","in":"query","required":false,"description":"Mortar joint (in, default 0.375)","schema":{"type":"string"}},{"name":"waste_percent","in":"query","required":false,"description":"Waste % (default 5)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Blocks/ft² = 144 / ((L+joint)·(H+joint)). A standard 16×8\" CMU with a 3/8\" joint is 1.125/ft². Mortar ≈ 2.5 bags per 100 blocks. Waste added then rounded up.","inputs":{"joint":0.375,"area_sqft":320,"block_height":7.625,"block_length":15.625,"waste_percent":5},"mortar_bags":10,"blocks_needed":378,"blocks_no_waste":360,"blocks_per_sqft":1.125},"meta":{"timestamp":"2026-06-05T21:48:47.066Z","request_id":"21b6f3de-08bb-4a32-a53c-5218b1bc6d67"},"status":"ok","message":"Block estimate","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/brick":{"get":{"operationId":"get_v1_brick","tags":["Masonry"],"summary":"Bricks + mortar for a wall","description":"","parameters":[{"name":"area","in":"query","required":false,"description":"Wall area (ft², or use length+height)","schema":{"type":"string"},"example":"100"},{"name":"length","in":"query","required":false,"description":"Wall length (ft)","schema":{"type":"string"}},{"name":"height","in":"query","required":false,"description":"Wall height (ft)","schema":{"type":"string"}},{"name":"brick_length","in":"query","required":false,"description":"Brick face length (in, default 7.625)","schema":{"type":"string"}},{"name":"brick_height","in":"query","required":false,"description":"Brick face height (in, default 2.25)","schema":{"type":"string"}},{"name":"joint","in":"query","required":false,"description":"Mortar joint (in, default 0.375)","schema":{"type":"string"}},{"name":"waste_percent","in":"query","required":false,"description":"Waste % (default 5)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Bricks/ft² = 144 / ((L+joint)·(H+joint)). A standard modular brick with a 3/8\" joint is 6.86/ft². Mortar ≈ 7 bags per 1000 bricks. Waste added then rounded up.","inputs":{"joint":0.375,"area_sqft":100,"brick_height":2.25,"brick_length":7.625,"waste_percent":5},"mortar_bags":6,"bricks_needed":720,"bricks_no_waste":686,"bricks_per_sqft":6.8571},"meta":{"timestamp":"2026-06-05T21:48:47.168Z","request_id":"a201b037-be1e-42c0-b84a-d9182e8fb449"},"status":"ok","message":"Brick estimate","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Imperial: unit face in inches, wall in square feet (or length × height in feet). Defaults are a modular brick and a standard CMU with a 3/8\" mortar joint. For poured-concrete volume use a concrete API.","service":"masonry-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"Concrete-block (CMU) count and mortar bags for a wall area (16×8\" default).","GET /v1/brick":"Brick count and mortar bags for a wall area (modular brick default)."},"description":"Masonry estimating: bricks and concrete blocks (CMU) for a wall, plus the mortar bags to lay them."},"meta":{"timestamp":"2026-06-05T21:48:47.253Z","request_id":"add42c12-1517-4276-94b3-efd04508fff6"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5150,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":395,"monthly_call_quota":52000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1110,"monthly_call_quota":218000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3500,"monthly_call_quota":1310000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/masonry-api"}