Electrical Engineering & Installation Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/electrical-engineering/load-schedule-calculate$0.04 USDC

Calculate electrical load schedules

Calculate kW, kVA, and current for caller-supplied loads using supplied voltage and power factor. Missing values are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3,
    "powerFactor": 0.9
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "loadCount": 2,
  "totalKw": 53,
  "totalKwSupplied": true,
  "totalKva": 61.3623,
  "totalKvaSupplied": true,
  "items": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "quantity": 1,
      "voltageV": 400,
      "voltageSupplied": true,
      "kw": 45,
      "kwSupplied": true,
      "kva": 52.9412,
      "kvaSupplied": true,
      "currentA": 76.414,
      "currentSupplied": true,
      "powerFactor": 0.85,
      "powerFactorSupplied": true,
      "threePhase": true,
      "continuous": true,
      "continuousSupplied": true,
      "notes": "",
      "standardsInvented": false,
      "codeComplianceClaimed": false
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "quantity": 1,
      "voltageV": 400,
      "voltageSupplied": true,
      "kw": 8,
      "kwSupplied": true,
      "kva": 8.4211,
      "kvaSupplied": true,
      "currentA": 21.0526,
      "currentSupplied": true,
      "powerFactor": 0.95,
      "powerFactorSupplied": true,
      "threePhase": false,
      "continuous": false,
      "continuousSupplied": false,
      "notes": "",
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/load-schedule-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3,
    "powerFactor": 0.9
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/three-phase-load-balance-check$0.03 USDC

Check three-phase load balance

Compare phase-leg currents from supplied loads and report imbalance percentage. Optional caller rule thresholds are compared when provided.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    },
    {
      "id": "L3",
      "name": "Lighting B",
      "phase": "B",
      "kw": 7,
      "powerFactor": 0.95
    },
    {
      "id": "L4",
      "name": "Lighting C",
      "phase": "C",
      "kw": 9,
      "powerFactor": 0.95
    }
  ],
  "rules": [
    {
      "id": "RL-BAL",
      "code": "CALLER-IMBALANCE",
      "description": "Caller imbalance limit",
      "threshold": 10,
      "unit": "%",
      "subject": "imbalance",
      "source": "Caller project spec"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "checked",
  "phaseA_A": 21.0526,
  "phaseASupplied": true,
  "phaseB_A": 18.4211,
  "phaseBSupplied": true,
  "phaseC_A": 23.6842,
  "phaseCSupplied": true,
  "maxPhaseA": 23.6842,
  "maxPhaseSupplied": true,
  "minPhaseA": 18.4211,
  "minPhaseSupplied": true,
  "imbalancePct": 12.4999,
  "imbalancePctSupplied": true,
  "withinCallerThreshold": false,
  "withinCallerThresholdSupplied": true,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "caller_rule_exceeded",
      "subject": "RL-BAL",
      "detail": "Phase imbalance 12.4999% exceeds caller-supplied threshold 10."
    }
  ],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/three-phase-load-balance-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    },
    {
      "id": "L3",
      "name": "Lighting B",
      "phase": "B",
      "kw": 7,
      "powerFactor": 0.95
    },
    {
      "id": "L4",
      "name": "Lighting C",
      "phase": "C",
      "kw": 9,
      "powerFactor": 0.95
    }
  ],
  "rules": [
    {
      "id": "RL-BAL",
      "code": "CALLER-IMBALANCE",
      "description": "Caller imbalance limit",
      "threshold": 10,
      "unit": "%",
      "subject": "imbalance",
      "source": "Caller project spec"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/voltage-drop-calculate$0.04 USDC

Calculate voltage drop

Calculate voltage drop from supplied cable resistance/reactance, length, and load current. Cable tables are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    }
  ],
  "cables": [
    {
      "id": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "resistanceOhmPerKm": 0.32,
      "reactanceOhmPerKm": 0.08,
      "lengthM": 60,
      "conductors": 1
    }
  ],
  "rules": [
    {
      "id": "RL1",
      "code": "CALLER-VD",
      "description": "Caller voltage-drop limit",
      "threshold": 5,
      "unit": "%",
      "subject": "voltage_drop_pct",
      "source": "Caller project spec"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "cableCount": 1,
  "items": [
    {
      "cableId": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "lengthM": 60,
      "lengthSupplied": true,
      "currentA": 76.414,
      "currentSupplied": true,
      "voltageV": 400,
      "voltageSupplied": true,
      "voltageDropV": 2.6194,
      "voltageDropSupplied": true,
      "voltageDropPct": 0.6548,
      "voltageDropPctSupplied": true,
      "callerRules": [
        {
          "ruleId": "RL1",
          "code": "CALLER-VD",
          "description": "Caller voltage-drop limit",
          "threshold": 5,
          "unit": "%",
          "value": 0.6548,
          "exceeded": false,
          "source": "Caller project spec",
          "standardsInvented": false,
          "codeComplianceClaimed": false
        }
      ],
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/voltage-drop-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    }
  ],
  "cables": [
    {
      "id": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "resistanceOhmPerKm": 0.32,
      "reactanceOhmPerKm": 0.08,
      "lengthM": 60,
      "conductors": 1
    }
  ],
  "rules": [
    {
      "id": "RL1",
      "code": "CALLER-VD",
      "description": "Caller voltage-drop limit",
      "threshold": 5,
      "unit": "%",
      "subject": "voltage_drop_pct",
      "source": "Caller project spec"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/cable-sizing-calculate$0.04 USDC

Check cable sizing

Compare calculated design current to caller-supplied cable ampacity. Ampacity tables are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3,
    "continuousFactor": 1.25
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85,
      "continuous": true
    }
  ],
  "cables": [
    {
      "id": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "ampacityA": 125,
      "sizeLabel": "35mm2",
      "material": "Cu"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "cableCount": 1,
  "items": [
    {
      "cableId": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "sizeLabel": "35mm2",
      "material": "Cu",
      "requiredCurrentA": 76.414,
      "requiredCurrentSupplied": true,
      "designCurrentA": 95.5175,
      "designCurrentSupplied": true,
      "continuousFactor": 1.25,
      "continuousFactorSupplied": true,
      "ampacityA": 125,
      "ampacitySupplied": true,
      "adequate": true,
      "adequateSupplied": true,
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/cable-sizing-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3,
    "continuousFactor": 1.25
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85,
      "continuous": true
    }
  ],
  "cables": [
    {
      "id": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "ampacityA": 125,
      "sizeLabel": "35mm2",
      "material": "Cu"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/breaker-rating-check$0.03 USDC

Check breaker ratings

Compare calculated design current to caller-supplied breaker ratings and continuous factors. Code rules are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    }
  ],
  "breakers": [
    {
      "id": "BK1",
      "loadId": "L1",
      "ratingA": 100,
      "continuousFactor": 1.25,
      "poles": 3,
      "type": "MCCB"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "checked",
  "breakerCount": 1,
  "items": [
    {
      "breakerId": "BK1",
      "loadId": "L1",
      "type": "MCCB",
      "poles": 3,
      "polesSupplied": true,
      "loadCurrentA": 76.414,
      "loadCurrentSupplied": true,
      "continuousFactor": 1.25,
      "continuousFactorSupplied": true,
      "designCurrentA": 95.5175,
      "designCurrentSupplied": true,
      "ratingA": 100,
      "ratingSupplied": true,
      "adequate": true,
      "adequateSupplied": true,
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/breaker-rating-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    }
  ],
  "breakers": [
    {
      "id": "BK1",
      "loadId": "L1",
      "ratingA": 100,
      "continuousFactor": 1.25,
      "poles": 3,
      "type": "MCCB"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/transformer-capacity-calculate$0.04 USDC

Calculate transformer capacity

Compare transformer rated kVA to supplied or schedule load kVA and report loading percentage.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    }
  ],
  "transformers": [
    {
      "id": "XF1",
      "name": "Main TX",
      "ratedKva": 250,
      "primaryV": 11000,
      "secondaryV": 400,
      "impedancePct": 4.5
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "transformerCount": 1,
  "items": [
    {
      "id": "XF1",
      "name": "Main TX",
      "ratedKva": 250,
      "ratedKvaSupplied": true,
      "loadKva": 61.3623,
      "loadKvaSupplied": true,
      "loadingPct": 24.5449,
      "loadingPctSupplied": true,
      "adequate": true,
      "adequateSupplied": true,
      "primaryV": 11000,
      "primaryVSupplied": true,
      "secondaryV": 400,
      "secondaryVSupplied": true,
      "primaryCurrentA": 13.1216,
      "primaryCurrentSupplied": true,
      "secondaryCurrentA": 360.8439,
      "secondaryCurrentSupplied": true,
      "impedancePct": 4.5,
      "impedancePctSupplied": true,
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/transformer-capacity-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    }
  ],
  "transformers": [
    {
      "id": "XF1",
      "name": "Main TX",
      "ratedKva": 250,
      "primaryV": 11000,
      "secondaryV": 400,
      "impedancePct": 4.5
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/power-factor-correction-calculate$0.03 USDC

Calculate power factor correction

Calculate required kVAR (and optional capacitance) to move from a supplied power factor to a supplied target.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "powerFactorCases": [
    {
      "id": "PF1",
      "kw": 80,
      "powerFactor": 0.8,
      "targetPowerFactor": 0.95,
      "voltageV": 400,
      "frequencyHz": 50
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "caseCount": 1,
  "items": [
    {
      "id": "PF1",
      "kw": 80,
      "kwSupplied": true,
      "powerFactor": 0.8,
      "powerFactorSupplied": true,
      "targetPowerFactor": 0.95,
      "targetPowerFactorSupplied": true,
      "requiredKvar": 33.7053,
      "requiredKvarSupplied": true,
      "voltageV": 400,
      "voltageSupplied": true,
      "frequencyHz": 50,
      "frequencySupplied": true,
      "capacitanceUF": 670.5456,
      "capacitanceSupplied": true,
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/power-factor-correction-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "powerFactorCases": [
    {
      "id": "PF1",
      "kw": 80,
      "powerFactor": 0.8,
      "targetPowerFactor": 0.95,
      "voltageV": 400,
      "frequencyHz": 50
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/generator-sizing-calculate$0.04 USDC

Calculate generator sizing

Size required generator kVA from supplied load and caller diversity, reserve, and derate factors.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "generators": [
    {
      "id": "GN1",
      "name": "Standby",
      "loadKw": 70,
      "powerFactor": 0.8,
      "diversityFactor": 1,
      "reserveFactor": 1.15,
      "altitudeDerate": 1,
      "temperatureDerate": 1,
      "ratedKva": 125
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "generatorCount": 1,
  "items": [
    {
      "id": "GN1",
      "name": "Standby",
      "loadKw": 70,
      "loadKwSupplied": true,
      "loadKva": 87.5,
      "loadKvaSupplied": true,
      "powerFactor": 0.8,
      "powerFactorSupplied": true,
      "diversityFactor": 1,
      "diversityFactorSupplied": true,
      "reserveFactor": 1.15,
      "reserveFactorSupplied": true,
      "altitudeDerate": 1,
      "altitudeDerateSupplied": true,
      "temperatureDerate": 1,
      "temperatureDerateSupplied": true,
      "requiredKva": 100.625,
      "requiredKvaSupplied": true,
      "ratedKva": 125,
      "ratedKvaSupplied": true,
      "adequate": true,
      "adequateSupplied": true,
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/generator-sizing-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "generators": [
    {
      "id": "GN1",
      "name": "Standby",
      "loadKw": 70,
      "powerFactor": 0.8,
      "diversityFactor": 1,
      "reserveFactor": 1.15,
      "altitudeDerate": 1,
      "temperatureDerate": 1,
      "ratedKva": 125
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/ev-charger-load-capacity-check$0.04 USDC

Check EV charger load capacity

Check EV charger design current against caller-supplied panel capacity and existing load. Continuous factors are used only when supplied.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "chargers": [
    {
      "id": "EV1",
      "name": "Wallbox",
      "voltageV": 400,
      "currentA": 32,
      "quantity": 2,
      "continuous": true,
      "continuousFactor": 1.25,
      "panelCapacityA": 125,
      "existingLoadA": 40,
      "phases": 3
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "checked",
  "chargerCount": 1,
  "items": [
    {
      "id": "EV1",
      "name": "Wallbox",
      "quantity": 2,
      "voltageV": 400,
      "voltageSupplied": true,
      "unitCurrentA": 32,
      "unitCurrentSupplied": true,
      "continuousFactor": 1.25,
      "continuousFactorSupplied": true,
      "designCurrentA": 80,
      "designCurrentSupplied": true,
      "existingLoadA": 40,
      "existingLoadSupplied": true,
      "panelCapacityA": 125,
      "panelCapacitySupplied": true,
      "totalLoadA": 120,
      "totalLoadSupplied": true,
      "remainingCapacityA": 5,
      "remainingCapacitySupplied": true,
      "adequate": true,
      "adequateSupplied": true,
      "standardsInvented": false,
      "codeComplianceClaimed": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/ev-charger-load-capacity-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "chargers": [
    {
      "id": "EV1",
      "name": "Wallbox",
      "voltageV": 400,
      "currentA": 32,
      "quantity": 2,
      "continuous": true,
      "continuousFactor": 1.25,
      "panelCapacityA": 125,
      "existingLoadA": 40,
      "phases": 3
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electrical-engineering/design-document-audit$0.08 USDC

Audit electrical design documents

Audit completeness of supplied electrical design inputs and aggregate load, balance, drop, cable, breaker, transformer, PF, generator, and EV checks. Does not invent code compliance.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`loads`	No	array; Array
`cables`	No	array; Array
`breakers`	No	array; Array
`transformers`	No	array; Array
`powerFactorCases`	No	array; Array
`generators`	No	array; Array
`chargers`	No	array; Array
`rules`	No	array; Array
`system`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3,
    "frequencyHz": 50,
    "powerFactor": 0.9,
    "continuousFactor": 1.25
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85,
      "continuous": true
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    },
    {
      "id": "L3",
      "name": "Lighting B",
      "phase": "B",
      "kw": 7,
      "powerFactor": 0.95
    },
    {
      "id": "L4",
      "name": "Lighting C",
      "phase": "C",
      "kw": 9,
      "powerFactor": 0.95
    }
  ],
  "cables": [
    {
      "id": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "ampacityA": 125,
      "resistanceOhmPerKm": 0.32,
      "reactanceOhmPerKm": 0.08,
      "lengthM": 60,
      "conductors": 1,
      "material": "Cu",
      "sizeLabel": "35mm2"
    }
  ],
  "breakers": [
    {
      "id": "BK1",
      "loadId": "L1",
      "ratingA": 100,
      "continuousFactor": 1.25,
      "poles": 3,
      "type": "MCCB"
    }
  ],
  "transformers": [
    {
      "id": "XF1",
      "name": "Main TX",
      "ratedKva": 250,
      "primaryV": 11000,
      "secondaryV": 400,
      "impedancePct": 4.5
    }
  ],
  "powerFactorCases": [
    {
      "id": "PF1",
      "kw": 80,
      "powerFactor": 0.8,
      "targetPowerFactor": 0.95,
      "voltageV": 400,
      "frequencyHz": 50
    }
  ],
  "generators": [
    {
      "id": "GN1",
      "name": "Standby",
      "loadKw": 70,
      "powerFactor": 0.8,
      "diversityFactor": 1,
      "reserveFactor": 1.15,
      "altitudeDerate": 1,
      "temperatureDerate": 1,
      "ratedKva": 125
    }
  ],
  "chargers": [
    {
      "id": "EV1",
      "name": "Wallbox",
      "voltageV": 400,
      "currentA": 32,
      "quantity": 2,
      "continuous": true,
      "continuousFactor": 1.25,
      "panelCapacityA": 125,
      "existingLoadA": 40,
      "phases": 3
    }
  ],
  "rules": [
    {
      "id": "RL1",
      "code": "CALLER-VD",
      "description": "Caller voltage-drop limit",
      "threshold": 5,
      "unit": "%",
      "subject": "voltage_drop_pct",
      "source": "Caller project spec"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "audited",
  "asOf": "2026-11-04T21:00:00.000Z",
  "completeness": [
    {
      "section": "loads",
      "present": true,
      "count": 4
    },
    {
      "section": "cables",
      "present": true,
      "count": 1
    },
    {
      "section": "breakers",
      "present": true,
      "count": 1
    },
    {
      "section": "transformers",
      "present": true,
      "count": 1
    },
    {
      "section": "powerFactorCases",
      "present": true,
      "count": 1
    },
    {
      "section": "generators",
      "present": true,
      "count": 1
    },
    {
      "section": "chargers",
      "present": true,
      "count": 1
    },
    {
      "section": "rules",
      "present": true,
      "count": 1
    }
  ],
  "sections": {
    "loads": {
      "loadCount": 4,
      "totalKw": 69,
      "totalKwSupplied": true,
      "totalKva": 78.2044,
      "totalKvaSupplied": true
    },
    "phaseBalance": {
      "imbalancePct": 5.6564,
      "imbalancePctSupplied": true
    },
    "voltageDrop": {
      "cableCount": 1
    },
    "cableSizing": {
      "cableCount": 1
    },
    "breakers": {
      "breakerCount": 1
    },
    "transformers": {
      "transformerCount": 1
    },
    "powerFactor": {
      "caseCount": 1
    },
    "generators": {
      "generatorCount": 1
    },
    "chargers": {
      "chargerCount": 1
    }
  },
  "standardsInvented": false,
  "codeComplianceClaimed": false,
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "findings": [],
  "limitations": [
    "Loads, cables, breakers, transformers, power-factor cases, generators, chargers, and optional rule thresholds are copied only from labeled fields supplied by the caller.",
    "No paid engineering data provider is used and no API key is required.",
    "Deterministic formulas use caller-supplied voltages, currents, impedances, ratings, and factors. Missing values are not invented.",
    "Electrical code or safety compliance is not claimed. Caller-supplied rule thresholds are compared when present; standards tables are not invented.",
    "Cable ampacity tables, breaker continuous factors, and derating rules are applied only when the caller supplies those values."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electrical-engineering/design-document-audit" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "system": {
    "voltageV": 400,
    "phases": 3,
    "frequencyHz": 50,
    "powerFactor": 0.9,
    "continuousFactor": 1.25
  },
  "loads": [
    {
      "id": "L1",
      "name": "HVAC",
      "phase": "ABC",
      "kw": 45,
      "powerFactor": 0.85,
      "continuous": true
    },
    {
      "id": "L2",
      "name": "Lighting A",
      "phase": "A",
      "kw": 8,
      "powerFactor": 0.95
    },
    {
      "id": "L3",
      "name": "Lighting B",
      "phase": "B",
      "kw": 7,
      "powerFactor": 0.95
    },
    {
      "id": "L4",
      "name": "Lighting C",
      "phase": "C",
      "kw": 9,
      "powerFactor": 0.95
    }
  ],
  "cables": [
    {
      "id": "CB1",
      "loadId": "L1",
      "designation": "Feeder-1",
      "ampacityA": 125,
      "resistanceOhmPerKm": 0.32,
      "reactanceOhmPerKm": 0.08,
      "lengthM": 60,
      "conductors": 1,
      "material": "Cu",
      "sizeLabel": "35mm2"
    }
  ],
  "breakers": [
    {
      "id": "BK1",
      "loadId": "L1",
      "ratingA": 100,
      "continuousFactor": 1.25,
      "poles": 3,
      "type": "MCCB"
    }
  ],
  "transformers": [
    {
      "id": "XF1",
      "name": "Main TX",
      "ratedKva": 250,
      "primaryV": 11000,
      "secondaryV": 400,
      "impedancePct": 4.5
    }
  ],
  "powerFactorCases": [
    {
      "id": "PF1",
      "kw": 80,
      "powerFactor": 0.8,
      "targetPowerFactor": 0.95,
      "voltageV": 400,
      "frequencyHz": 50
    }
  ],
  "generators": [
    {
      "id": "GN1",
      "name": "Standby",
      "loadKw": 70,
      "powerFactor": 0.8,
      "diversityFactor": 1,
      "reserveFactor": 1.15,
      "altitudeDerate": 1,
      "temperatureDerate": 1,
      "ratedKva": 125
    }
  ],
  "chargers": [
    {
      "id": "EV1",
      "name": "Wallbox",
      "voltageV": 400,
      "currentA": 32,
      "quantity": 2,
      "continuous": true,
      "continuousFactor": 1.25,
      "panelCapacityA": 125,
      "existingLoadA": 40,
      "phases": 3
    }
  ],
  "rules": [
    {
      "id": "RL1",
      "code": "CALLER-VD",
      "description": "Caller voltage-drop limit",
      "threshold": 5,
      "unit": "%",
      "subject": "voltage_drop_pct",
      "source": "Caller project spec"
    }
  ]
}
JSON