{ "openapi": "3.1.0", "info": { "title": "BuildPulse API", "description": "BuildPulse — home construction and renovation intelligence: project cost estimates, contractor vetting, permit requirements, material pricing, ROI projections, and inspection checklists. Global coverage — jurisdiction-aware permits, codes, and costs (US and Canada deepest; UK/AU equivalents handled).", "version": "1.2.0", "contact": { "name": "The Aslan Group LLC", "url": "https://pulsenetwork.theaslangroupllc.com", "email": "info@theaslangroupllc.com" }, "x-agent-use-case": "on-demand", "x-agent-chaining": "Follow up with /gridpulse for solar/EV charger installation costs as part of a build; /propplus for property value impact of renovations; /insurepulse for builder risk insurance quotes.", "x-guidance": "# BuildPulse API (x402 pay-per-call)\n\nProfessional construction intelligence API. Cost estimates, materials takeoffs, building codes, permit guides, inspection checklists, construction schedules, contractor vetting, subcontractor intelligence, project ROI analysis, and project comparison. Global scope, any language.\n\nBase URL: https://buildpulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/build/code — $0.1 — Building code requirements by jurisdiction\n- GET /api/build/compare — $0.1 — Side-by-side project comparison for a given budget\n- GET /api/build/contractor — $0.1 — Contractor vetting guide with interview questions and red flags\n- GET /api/build/estimate — $0.15 — Detailed project cost estimate with line items\n- GET /api/build/inspect — $0.08 — Pre-inspection checklist by stage and project type\n- GET /api/build/materials — $0.1 — Full materials takeoff with quantities and pricing\n- GET /api/build/permit — $0.08 — Permit requirements, fees, and inspection sequence\n- GET /api/build/roi — $0.1 — Project ROI analysis: resale value, rental income, payback period\n- GET /api/build/schedule — $0.1 — Construction schedule with trade sequencing and critical path\n- GET /api/build/subcontractor — $0.1 — Subcontractor market rates, scope of work, and bid checklist\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)." }, "servers": [ { "url": "https://buildpulse.theaslangroupllc.com", "description": "Production" } ], "paths": { "/api/build/code": { "get": { "summary": "/api/build/code", "description": "/api/build/code", "x-agent-use-case": "on-demand", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/compare": { "get": { "summary": "/api/build/compare", "description": "/api/build/compare", "x-agent-use-case": "on-demand", "parameters": [ { "name": "projects", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "budget", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/contractor": { "get": { "summary": "/api/build/contractor", "description": "/api/build/contractor", "x-agent-use-case": "on-demand", "parameters": [ { "name": "trade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/estimate": { "get": { "summary": "/api/build/estimate", "description": "/api/build/estimate", "x-agent-use-case": "on-demand", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sqft", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "quality", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.15, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/inspect": { "get": { "summary": "/api/build/inspect", "description": "/api/build/inspect", "x-agent-use-case": "on-demand", "parameters": [ { "name": "stage", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.08, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/materials": { "get": { "summary": "/api/build/materials", "description": "/api/build/materials", "x-agent-use-case": "on-demand", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sqft", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "material", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/permit": { "get": { "summary": "/api/build/permit", "description": "/api/build/permit", "x-agent-use-case": "on-demand", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.08, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/roi": { "get": { "summary": "BuildPulse project ROI analysis — resale value, rental income, payback period, and alternatives", "description": "BuildPulse project ROI analysis — resale value, rental income, payback period, and alternatives", "x-agent-use-case": "on-demand", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "home_value", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/schedule": { "get": { "summary": "/api/build/schedule", "description": "/api/build/schedule", "x-agent-use-case": "on-demand", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/build/subcontractor": { "get": { "summary": "/api/build/subcontractor", "description": "/api/build/subcontractor", "x-agent-use-case": "on-demand", "parameters": [ { "name": "trade", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "zip", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paid construction intelligence response (JSON)." }, "402": { "description": "Payment required — x402 USDC on Base." } }, "x-price-usd": 0.1, "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } } } }