{"uid":"cap__b4VZAE-mHTJzDlPul9Yf","slug":"brainiac-electricity-bill-tariff-reconciliation-api-d21eb2b1","name":"BRAINIAC Electricity Bill Tariff Reconciliation API","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/electricity-market/bill-tariff-reconcile?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"feed":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":500}},"additionalProperties":false},"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},"kwh":{"type":"number","maximum":1000000000,"minimum":0},"peakKw":{"type":"number","maximum":1000000000,"minimum":0},"source":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"tariffId":{"type":"string","maxLength":80},"periodEnd":{"type":"string","maxLength":40},"billedFixed":{"type":"number","maximum":1000000000,"minimum":0},"billedTotal":{"type":"number","maximum":1000000000,"minimum":0},"periodStart":{"type":"string","maxLength":40},"billedDemand":{"type":"number","maximum":1000000000,"minimum":0},"billedEnergy":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"carbon":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"index":{"type":"string","maxLength":40},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"intensity":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":1000},"demand":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"mw":{"type":"number","maximum":1000000000,"minimum":0},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false},"maxItems":1000},"prices":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"price":{"type":"number","maximum":1000000,"minimum":-1000000},"market":{"type":"string","maxLength":120},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"product":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12}},"additionalProperties":false},"maxItems":1000},"outages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cause":{"type":"string","maxLength":200},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"status":{"type":"string","maxLength":80},"endedAt":{"type":"string","maxLength":40},"startedAt":{"type":"string","maxLength":40},"customersAffected":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500},"tariffs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"demandUnit":{"type":"string","maxLength":40},"energyRate":{"type":"number","maximum":1000000,"minimum":0},"fixedCharge":{"type":"number","maximum":1000000000,"minimum":0},"peakDemandRate":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":100},"exposures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"market":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"volumeMwh":{"type":"number","maximum":1000000000,"minimum":0},"hedgeRatio":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},"maxItems":100},"worldBank":{"type":"object","properties":{"country":{"type":"string","maxLength":3,"minLength":2},"perPage":{"type":"integer","maximum":60,"minimum":1},"indicator":{"type":"string","maxLength":80,"minLength":3}},"additionalProperties":false},"generation":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"mw":{"type":"number","maximum":1000000000,"minimum":0},"fuel":{"type":"string","maxLength":80},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"isForecast":{"type":"boolean"}},"additionalProperties":false},"maxItems":1000},"carbonIntensity":{"type":"object","properties":{"fetch":{"type":"boolean"},"forecast":{"type":"boolean"},"regionId":{"type":"integer","maximum":18,"minimum":1}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"items":[{"kwh":12000,"billId":"BL-1","peakKw":95,"currency":"GBP","tariffId":"TF-1","variance":0,"periodEnd":"2026-10-31","billedTotal":2607.5,"kwhSupplied":true,"periodStart":"2026-10-01","expectedFixed":120,"expectedTotal":2607.5,"apiKeyRequired":false,"expectedDemand":807.5,"expectedEnergy":1680,"peakKwSupplied":true,"paidProviderUsed":false,"varianceSupplied":true,"billedTotalSupplied":true,"expectedFixedSupplied":true,"expectedTotalSupplied":true,"billingAccuracyClaimed":false,"expectedDemandSupplied":true,"expectedEnergySupplied":true}],"status":"reconciled","findings":[],"billCount":1,"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.","No paid energy data provider is used and no API key is required.","Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.","Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.","Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."],"publicSources":[],"apiKeyRequired":false,"forecastInvented":false,"paidProviderUsed":false,"billingAccuracyClaimed":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_EvMF_IcSwBKfAugK_ek3r","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":"Reconciles electricity bills against supplied tariff rates, usage data, and demand figures to detect billing errors and variances","exampleAgentPrompt":"Can you check whether this electricity bill for October 2026 is correct? I'll give you the bill details showing 12,000 kWh used, a peak demand of 95 kW, and a billed total of £2,607.50 — please reconcile it against tariff TF-1 with a fixed charge of £120, an energy rate, and a demand rate to see if the numbers add up.","exampleUseCases":[{"title":"Commercial facility bill audit","prompt":"I have a CSV export of our last six electricity bills for our warehouse — can you check each one against our current tariff schedule and tell me which months we were overcharged or undercharged and by how much?"},{"title":"Energy manager variance report","prompt":"We just received our October electricity invoice showing a billed total of £2,607.50 for 12,000 kWh and 95 kW peak demand under tariff TF-1. Can you reconcile this against the expected fixed, energy, and demand charges and flag any variance?"},{"title":"Automated invoice validation pipeline","prompt":"Before we pay this month's electricity invoice, run a reconciliation on the attached bill JSON against tariff ID TF-99 and let me know if the total matches what we should expect — flag any discrepancies so we can dispute them with the supplier."}],"resultDescription":"Returns a reconciliation result per bill including expected fixed, energy, and demand charges, expected total, billed total, and variance amount; overall status ('reconciled' or error); a findings array for detected discrepancies; a list of data limitations (e.g. no paid provider used, missing values not invented); and flags indicating which values were actually supplied vs assumed.","failureModes":["Missing required bill fields (kwh, billedTotal, tariffId) result in incomplete reconciliation with null expected values","Tariff rates not supplied means expected charges cannot be computed — service will not invent rates","Price feed URL unreachable causes feed data to be omitted with a limitation note","Malformed CSV or JSON input returns a parse error","Exceeding maxItems (200 bills) or maxLength constraints returns a validation error","Currency mismatches between bills and tariff rates are flagged as a limitation"],"whenToPreferThis":"Use this endpoint when you need to verify whether an electricity bill is arithmetically correct given known tariff rates and usage data, without needing a paid energy data subscription. It is ideal for agents that have bill data and tariff schedules already and need a structured reconciliation output — including variance detection and findings — rather than raw data lookup or market price retrieval. It does not invent missing rates or usage figures, so all tariff rates and quantities must be supplied by the caller.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:50.964Z","isFirstParty":false,"canonicalSlug":"brainiac-electricity-bill-tariff-reconciliation-api-d21eb2b1"}