{"openapi":"3.1.0","info":{"title":"Electrical Engineering & Installation Intelligence API","version":"1.0.0","description":"Run deterministic load schedules, phase balance, voltage drop, cable sizing, breaker checks, transformer capacity, power-factor correction, generator sizing, EV charger capacity, and design-document audits from caller-supplied parameters—without inventing electrical standards. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/electrical-engineering/load-schedule-calculate":{"post":{"operationId":"calculate_electrical_load_schedules","summary":"Calculate electrical load schedules","description":"Calculate kW, kVA, and current for caller-supplied loads using supplied voltage and power factor. Missing values are not invented.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"loadCount":{"type":"number"},"totalKw":{"type":"number"},"totalKwSupplied":{"type":"boolean"},"totalKva":{"type":"number"},"totalKvaSupplied":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"phase":{"type":"string"},"quantity":{"type":"number"},"voltageV":{"type":"number"},"voltageSupplied":{"type":"boolean"},"kw":{"type":"number"},"kwSupplied":{"type":"boolean"},"kva":{"type":"number"},"kvaSupplied":{"type":"boolean"},"currentA":{"type":"number"},"currentSupplied":{"type":"boolean"},"powerFactor":{"type":"number"},"powerFactorSupplied":{"type":"boolean"},"threePhase":{"type":"boolean"},"continuous":{"type":"boolean"},"continuousSupplied":{"type":"boolean"},"notes":{"type":"string"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/three-phase-load-balance-check":{"post":{"operationId":"check_three_phase_load_balance","summary":"Check three-phase load balance","description":"Compare phase-leg currents from supplied loads and report imbalance percentage. Optional caller rule thresholds are compared when provided.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"phaseA_A":{"type":"number"},"phaseASupplied":{"type":"boolean"},"phaseB_A":{"type":"number"},"phaseBSupplied":{"type":"boolean"},"phaseC_A":{"type":"number"},"phaseCSupplied":{"type":"boolean"},"maxPhaseA":{"type":"number"},"maxPhaseSupplied":{"type":"boolean"},"minPhaseA":{"type":"number"},"minPhaseSupplied":{"type":"boolean"},"imbalancePct":{"type":"number"},"imbalancePctSupplied":{"type":"boolean"},"withinCallerThreshold":{"type":"boolean"},"withinCallerThresholdSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/voltage-drop-calculate":{"post":{"operationId":"calculate_voltage_drop","summary":"Calculate voltage drop","description":"Calculate voltage drop from supplied cable resistance/reactance, length, and load current. Cable tables are not invented.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"cableCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"cableId":{"type":"string"},"loadId":{"type":"string"},"designation":{"type":"string"},"lengthM":{"type":"number"},"lengthSupplied":{"type":"boolean"},"currentA":{"type":"number"},"currentSupplied":{"type":"boolean"},"voltageV":{"type":"number"},"voltageSupplied":{"type":"boolean"},"voltageDropV":{"type":"number"},"voltageDropSupplied":{"type":"boolean"},"voltageDropPct":{"type":"number"},"voltageDropPctSupplied":{"type":"boolean"},"callerRules":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"code":{"type":"string"},"description":{"type":"string"},"threshold":{"type":"number"},"unit":{"type":"string"},"value":{"type":"number"},"exceeded":{"type":"boolean"},"source":{"type":"string"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/cable-sizing-calculate":{"post":{"operationId":"check_cable_sizing","summary":"Check cable sizing","description":"Compare calculated design current to caller-supplied cable ampacity. Ampacity tables are not invented.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"cableCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"cableId":{"type":"string"},"loadId":{"type":"string"},"designation":{"type":"string"},"sizeLabel":{"type":"string"},"material":{"type":"string"},"requiredCurrentA":{"type":"number"},"requiredCurrentSupplied":{"type":"boolean"},"designCurrentA":{"type":"number"},"designCurrentSupplied":{"type":"boolean"},"continuousFactor":{"type":"number"},"continuousFactorSupplied":{"type":"boolean"},"ampacityA":{"type":"number"},"ampacitySupplied":{"type":"boolean"},"adequate":{"type":"boolean"},"adequateSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/breaker-rating-check":{"post":{"operationId":"check_breaker_ratings","summary":"Check breaker ratings","description":"Compare calculated design current to caller-supplied breaker ratings and continuous factors. Code rules are not invented.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"breakerCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"breakerId":{"type":"string"},"loadId":{"type":"string"},"type":{"type":"string"},"poles":{"type":"number"},"polesSupplied":{"type":"boolean"},"loadCurrentA":{"type":"number"},"loadCurrentSupplied":{"type":"boolean"},"continuousFactor":{"type":"number"},"continuousFactorSupplied":{"type":"boolean"},"designCurrentA":{"type":"number"},"designCurrentSupplied":{"type":"boolean"},"ratingA":{"type":"number"},"ratingSupplied":{"type":"boolean"},"adequate":{"type":"boolean"},"adequateSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/transformer-capacity-calculate":{"post":{"operationId":"calculate_transformer_capacity","summary":"Calculate transformer capacity","description":"Compare transformer rated kVA to supplied or schedule load kVA and report loading percentage.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"transformerCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ratedKva":{"type":"number"},"ratedKvaSupplied":{"type":"boolean"},"loadKva":{"type":"number"},"loadKvaSupplied":{"type":"boolean"},"loadingPct":{"type":"number"},"loadingPctSupplied":{"type":"boolean"},"adequate":{"type":"boolean"},"adequateSupplied":{"type":"boolean"},"primaryV":{"type":"number"},"primaryVSupplied":{"type":"boolean"},"secondaryV":{"type":"number"},"secondaryVSupplied":{"type":"boolean"},"primaryCurrentA":{"type":"number"},"primaryCurrentSupplied":{"type":"boolean"},"secondaryCurrentA":{"type":"number"},"secondaryCurrentSupplied":{"type":"boolean"},"impedancePct":{"type":"number"},"impedancePctSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/power-factor-correction-calculate":{"post":{"operationId":"calculate_power_factor_correction","summary":"Calculate power factor correction","description":"Calculate required kVAR (and optional capacitance) to move from a supplied power factor to a supplied target.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","powerFactorCases":[{"id":"PF1","kw":80,"powerFactor":0.8,"targetPowerFactor":0.95,"voltageV":400,"frequencyHz":50}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"caseCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kw":{"type":"number"},"kwSupplied":{"type":"boolean"},"powerFactor":{"type":"number"},"powerFactorSupplied":{"type":"boolean"},"targetPowerFactor":{"type":"number"},"targetPowerFactorSupplied":{"type":"boolean"},"requiredKvar":{"type":"number"},"requiredKvarSupplied":{"type":"boolean"},"voltageV":{"type":"number"},"voltageSupplied":{"type":"boolean"},"frequencyHz":{"type":"number"},"frequencySupplied":{"type":"boolean"},"capacitanceUF":{"type":"number"},"capacitanceSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/generator-sizing-calculate":{"post":{"operationId":"calculate_generator_sizing","summary":"Calculate generator sizing","description":"Size required generator kVA from supplied load and caller diversity, reserve, and derate factors.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"generatorCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"loadKw":{"type":"number"},"loadKwSupplied":{"type":"boolean"},"loadKva":{"type":"number"},"loadKvaSupplied":{"type":"boolean"},"powerFactor":{"type":"number"},"powerFactorSupplied":{"type":"boolean"},"diversityFactor":{"type":"number"},"diversityFactorSupplied":{"type":"boolean"},"reserveFactor":{"type":"number"},"reserveFactorSupplied":{"type":"boolean"},"altitudeDerate":{"type":"number"},"altitudeDerateSupplied":{"type":"boolean"},"temperatureDerate":{"type":"number"},"temperatureDerateSupplied":{"type":"boolean"},"requiredKva":{"type":"number"},"requiredKvaSupplied":{"type":"boolean"},"ratedKva":{"type":"number"},"ratedKvaSupplied":{"type":"boolean"},"adequate":{"type":"boolean"},"adequateSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/ev-charger-load-capacity-check":{"post":{"operationId":"check_ev_charger_load_capacity","summary":"Check EV charger load capacity","description":"Check EV charger design current against caller-supplied panel capacity and existing load. Continuous factors are used only when supplied.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"chargerCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"quantity":{"type":"number"},"voltageV":{"type":"number"},"voltageSupplied":{"type":"boolean"},"unitCurrentA":{"type":"number"},"unitCurrentSupplied":{"type":"boolean"},"continuousFactor":{"type":"number"},"continuousFactorSupplied":{"type":"boolean"},"designCurrentA":{"type":"number"},"designCurrentSupplied":{"type":"boolean"},"existingLoadA":{"type":"number"},"existingLoadSupplied":{"type":"boolean"},"panelCapacityA":{"type":"number"},"panelCapacitySupplied":{"type":"boolean"},"totalLoadA":{"type":"number"},"totalLoadSupplied":{"type":"boolean"},"remainingCapacityA":{"type":"number"},"remainingCapacitySupplied":{"type":"boolean"},"adequate":{"type":"boolean"},"adequateSupplied":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/electrical-engineering/design-document-audit":{"post":{"operationId":"audit_electrical_design_documents","summary":"Audit electrical design documents","description":"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.","tags":["electrical-engineering"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"loads":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"phase":{"type":"string","enum":["1","3","A","B","C","AB","BC","CA","ABC"]},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000000},"kva":{"type":"number","minimum":0,"maximum":1000000000},"currentA":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0,"maximum":1},"continuous":{"type":"boolean"},"quantity":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"notes":{"type":"string","maxLength":300}},"additionalProperties":false}},"cables":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"designation":{"type":"string","maxLength":120},"ampacityA":{"type":"number","minimum":0,"maximum":1000000},"resistanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"reactanceOhmPerKm":{"type":"number","minimum":0,"maximum":1000000},"lengthM":{"type":"number","minimum":0,"maximum":1000000},"conductors":{"type":"integer","minimum":1,"maximum":100},"material":{"type":"string","maxLength":40},"sizeLabel":{"type":"string","maxLength":80}},"additionalProperties":false}},"breakers":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"loadId":{"type":"string","maxLength":80},"ratingA":{"type":"number","minimum":0,"maximum":1000000},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"poles":{"type":"integer","minimum":1,"maximum":4},"type":{"type":"string","maxLength":80}},"additionalProperties":false}},"transformers":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000},"primaryV":{"type":"number","minimum":0,"maximum":1000000},"secondaryV":{"type":"number","minimum":0,"maximum":1000000},"impedancePct":{"type":"number","minimum":0,"maximum":100},"loadKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"powerFactorCases":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kw":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"targetPowerFactor":{"type":"number","minimum":0.01,"maximum":1},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"frequencyHz":{"type":"number","minimum":0,"maximum":1000}},"additionalProperties":false}},"generators":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"loadKw":{"type":"number","minimum":0,"maximum":1000000000},"loadKva":{"type":"number","minimum":0,"maximum":1000000000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"diversityFactor":{"type":"number","minimum":0,"maximum":10},"reserveFactor":{"type":"number","minimum":0,"maximum":10},"altitudeDerate":{"type":"number","minimum":0,"maximum":1},"temperatureDerate":{"type":"number","minimum":0,"maximum":1},"ratedKva":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"chargers":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"voltageV":{"type":"number","minimum":0,"maximum":1000000},"currentA":{"type":"number","minimum":0,"maximum":1000000},"kw":{"type":"number","minimum":0,"maximum":1000000},"quantity":{"type":"number","minimum":0,"maximum":1000000},"continuous":{"type":"boolean"},"continuousFactor":{"type":"number","minimum":0,"maximum":2},"panelCapacityA":{"type":"number","minimum":0,"maximum":1000000},"existingLoadA":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false}},"rules":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"threshold":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"subject":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"system":{"type":"object","properties":{"voltageV":{"type":"number","minimum":0,"maximum":1000000},"phases":{"type":"integer","minimum":1,"maximum":3},"frequencyHz":{"type":"number","minimum":0,"maximum":1000},"powerFactor":{"type":"number","minimum":0.01,"maximum":1},"continuousFactor":{"type":"number","minimum":0,"maximum":2}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"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"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"asOf":{"type":"string"},"completeness":{"type":"array","items":{"type":"object","properties":{"section":{"type":"string"},"present":{"type":"boolean"},"count":{"type":"number"}},"additionalProperties":true}},"sections":{"type":"object","properties":{"loads":{"type":"object","properties":{"loadCount":{"type":"number"},"totalKw":{"type":"number"},"totalKwSupplied":{"type":"boolean"},"totalKva":{"type":"number"},"totalKvaSupplied":{"type":"boolean"}},"additionalProperties":true},"phaseBalance":{"type":"object","properties":{"imbalancePct":{"type":"number"},"imbalancePctSupplied":{"type":"boolean"}},"additionalProperties":true},"voltageDrop":{"type":"object","properties":{"cableCount":{"type":"number"}},"additionalProperties":true},"cableSizing":{"type":"object","properties":{"cableCount":{"type":"number"}},"additionalProperties":true},"breakers":{"type":"object","properties":{"breakerCount":{"type":"number"}},"additionalProperties":true},"transformers":{"type":"object","properties":{"transformerCount":{"type":"number"}},"additionalProperties":true},"powerFactor":{"type":"object","properties":{"caseCount":{"type":"number"}},"additionalProperties":true},"generators":{"type":"object","properties":{"generatorCount":{"type":"number"}},"additionalProperties":true},"chargers":{"type":"object","properties":{"chargerCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"standardsInvented":{"type":"boolean"},"codeComplianceClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}