# BRAINIAC Electricity Bill Tariff Reconciliation API

> BRAINIAC Electricity Bill Tariff Reconciliation API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-12).

Reconciles electricity bills against supplied tariff rates, usage data, and demand figures to detect billing errors and variances

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/electricity-market/bill-tariff-reconcile?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-electricity-bill-tariff-reconciliation-api-d21eb2b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__b4VZAE-mHTJzDlPul9Yf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-electricity-bill-tariff-reconciliation-api-d21eb2b1 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
     },
     "re
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-electricity-bill-tariff-reconciliation-api-d21eb2b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
