{"uid":"cap_Q7CevEdkUWV63E_Pnm1hM","slug":"brainiac-building-energy-occupancy-compare-47b08919","name":"BRAINIAC Building Energy Occupancy Compare","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/building-energy/occupancy-compare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cost":{"type":"number","maximum":1000000000,"minimum":0},"unit":{"type":"string","maxLength":40},"utility":{"type":"string","maxLength":80},"quantity":{"type":"number","maximum":1000000000,"minimum":0},"periodEnd":{"type":"string","maxLength":40},"buildingId":{"type":"string","maxLength":80},"periodStart":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":200},"meters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"unit":{"type":"string","maxLength":40},"utility":{"type":"string","maxLength":80},"buildingId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":200},"tariffs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","maximum":1000000,"minimum":0},"unit":{"type":"string","maxLength":40},"utility":{"type":"string","maxLength":80},"fixedCharge":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":100},"readings":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"value":{"type":"number","maximum":1000000000,"minimum":0},"meterId":{"type":"string","maxLength":80},"buildingId":{"type":"string","maxLength":80},"cumulative":{"type":"boolean"}},"additionalProperties":false},"maxItems":1000},"buildings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"number","maximum":1000000000,"minimum":0},"name":{"type":"string","maxLength":200},"areaUnit":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":100},"equipment":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"type":{"type":"string","maxLength":80},"setpoint":{"type":"number","maximum":200,"minimum":-100},"buildingId":{"type":"string","maxLength":80},"efficiency":{"type":"number","maximum":1000000,"minimum":0},"faultCount":{"type":"number","maximum":1000000,"minimum":0},"returnTemp":{"type":"number","maximum":200,"minimum":-100},"supplyTemp":{"type":"number","maximum":200,"minimum":-100},"installedAt":{"type":"string","maxLength":40},"capacityUnit":{"type":"string","maxLength":40},"runtimeHours":{"type":"number","maximum":1000000000,"minimum":0},"lastServiceAt":{"type":"string","maxLength":40},"ratedCapacity":{"type":"number","maximum":1000000000,"minimum":0},"nextServiceDue":{"type":"string","maxLength":40},"ratedEfficiency":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"occupancy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"occupants":{"type":"number","maximum":1000000,"minimum":0},"periodEnd":{"type":"string","maxLength":40},"buildingId":{"type":"string","maxLength":80},"periodStart":{"type":"string","maxLength":40},"hoursOccupied":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":200}}},"responseSchema":{"type":"json","example":{"items":[{"unit":"kWh","reason":"Compared because overlapping/matching periods and compatible energy units were supplied.","periodEnd":"2026-11-08","compatible":true,"periodStart":"2026-11-01","leftQuantity":200,"leftOccupants":100,"rightQuantity":120,"leftBuildingId":"B-1","rightOccupants":80,"tariffInvented":false,"leftPerOccupant":2,"rightBuildingId":"B-2","rightPerOccupant":1.5,"savingsGuaranteed":false,"leftPerOccupantSupplied":true,"rightPerOccupantSupplied":true}],"status":"compared","findings":[{"code":"tariff","kind":"missing","detail":"No supplied tariff matched this meter utility/unit, so cost was not calculated.","subject":"M-1"},{"code":"tariff","kind":"missing","detail":"No supplied tariff matched this meter utility/unit, so cost was not calculated.","subject":"M-2"}],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Meter readings, bills, tariffs, equipment records, and occupancy rows are copied only from labeled fields supplied by the caller.","Consumption and cost use supplied units and tariffs only. Missing tariffs are not invented.","Unusual usage is compared against a baseline calculated from supplied readings for the same meter or utility.","Buildings are compared only when measurement periods and units are compatible.","Equipment performance and savings are never invented. HVAC and connected equipment are never controlled."],"tariffInvented":false,"compatibleCount":1,"savingsGuaranteed":false,"equipmentControlled":false,"performanceInvented":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4J1baYs_n9wq-adPTXA_-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares energy consumption per occupant across two buildings (or periods) using supplied meter readings, bills, tariffs, and occupancy data, returning a structured compatibility assessment and per-occupant efficiency metrics.","exampleAgentPrompt":"Compare the energy efficiency of our two office buildings — Building B-1 had 100 occupants using 200 kWh and Building B-2 had 80 occupants using 120 kWh over the same week from November 1 to November 8, 2026. Tell me which building is more efficient per person.","exampleUseCases":[{"title":"Portfolio energy benchmarking by occupancy","prompt":"I have two office buildings: HQ had 150 occupants consuming 450 kWh last month, and the downtown branch had 90 occupants consuming 200 kWh over the same period. Compare their per-occupant energy usage and tell me which is more efficient."},{"title":"ESG reporting per-occupant metrics","prompt":"For our sustainability report, compare the electricity consumption per occupant between our London facility (200 occupants, 1800 kWh, Oct 1–Oct 31) and our Manchester facility (120 occupants, 900 kWh, Oct 1–Oct 31) — I'll supply meter readings and tariff info."},{"title":"Lease negotiation energy cost comparison","prompt":"We're deciding between two buildings to lease. Building A housed 60 people and used 300 kWh in September, Building B housed 80 people and used 320 kWh in September. Can you normalize the energy usage per occupant and show me the cost difference using our tariff of $0.12 per kWh?"}],"resultDescription":"Returns a list of comparison items, each containing the period, unit, left and right building IDs, total quantities, occupant counts, per-occupant consumption figures, compatibility flag, and an explanation reason. Also includes findings (e.g. missing tariff warnings), a checkedAt timestamp, a list of limitations (e.g. no equipment control, no invented savings), and flags for tariffInvented, savingsGuaranteed, equipmentControlled, and performanceInvented — all set to false for transparency.","failureModes":["Incompatible periods or units between buildings result in compatible:false with no comparison item produced","Missing tariff data produces a findings entry with code 'tariff' and kind 'missing', and cost is not calculated","Buildings with no overlapping measurement periods cannot be compared","Malformed or missing meter/reading arrays may result in empty items array","Exceeding maxItems limits (200 meters, 200 bills, 100 tariffs) may cause truncation or rejection","Invalid date formats in periodStart/periodEnd or asOf fields may cause parsing errors"],"whenToPreferThis":"Use this endpoint when you need to compare energy consumption normalized by occupancy across two buildings or time periods, using your own meter readings, utility bills, and tariff data. It is specifically designed for per-occupant energy benchmarking with explicit handling of missing tariffs, unit compatibility checks, and transparent limitation disclosures — preferred over generic analytics when you need auditable, compliance-friendly building energy comparison with no invented data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:56.772Z","isFirstParty":false,"canonicalSlug":"brainiac-building-energy-occupancy-compare-47b08919"}