API Reference

HTTP APIs for distribution engineering — parsers, analyzers, and workflow services. All speak the Universal Pole Model.

The platform is organized as HTTP services on top of two shared engineering models: the Universal Pole Model for overhead distribution and the Universal Vault Model for underground. Parsers produce these documents, analyzers consume them, and exporters write them back out into the source format.

Most integrations start with a parser (to convert a source file into a UPM document) and then call one or more analyzers directly. The QA/QC API bundles all overhead analyzers into a single batch call if you want a full portfolio sweep in one request.

All services authenticate with a bearer API key and return JSON.

Get started

Getting started

What you can build, what you need (API key + base URL), a 30-second curl example.

Authentication

Bearer token header, where keys come from, scoping rules.

Universal Pole Model

The shared JSON document every overhead service speaks. Read this once and the rest of the docs become reference.

Concurrent work orders

Git-style branch, review, and merge for a physical pole. Analysis-aware merge classifies data vs engineering conflicts.

Overhead — parsers and on-ramps

Everything that turns a source file or capture into a Universal Pole Model.

SPIDA API

Parse SPIDAcalc payloads into UPM and generate SPIDA-compatible output. The most mature parser today.

PLS API

.frm-catalog-driven generation: parse .pol (+ optional .loa) into UPM; emit a .pls.zip bundle that PLS-CADD imports cleanly.

O-Calc API

Parse O-Calc .pplx payloads into UPM. Catalog-free direct-writer generation handles 61/61 corpus files cleanly.

Field Capture API

Ingest drone, photogrammetry, LIDAR, and field-survey data into UPM. The on-ramp for everything that isn't a PLA file.

ESRI / ArcGIS API

Bidirectional ArcGIS sync — pull a polygon of poles in, push analyzed results back out.

Overhead — analyzers

Every analyzer accepts a UPM document and returns the same document with findings, proposals, or computed fields enriched.

Clearance API

CPUC GO-95 + NESC C2 + midspan separation checks. Pole-level and span-level.

Loading API

Code-aligned grade, district, conductor tensions, sag temperatures, and anchor-strength check (plate/PISA/non-PISA tables).

Sag API

Static sag with terrain ribbon, per-conductor case-4 verdicts, and forecast-driven storm sweep (Tomorrow.io → NWS → Open-Meteo).

Classification API

Circuit voltage, framing configuration, guying validation, midspan span-clearance.

Standards API

Per-utility construction standards as a queryable rules library. Ingest PDFs, validate poles against utility-specific rules.

QA/QC API

Batch orchestration — upload a project, run every analyzer across every pole, get per-pole loading + storm summaries and a portfolio scorecard.

Overhead — workflows

Higher-level services that consume findings from the analyzers and produce documents, cost estimates, or portfolio plans.

Joint-Use API

JP Form 2 rendering, FCC §1.1411 OTMR timeline, FCC §224 attachment rates, make-ready scope-of-work bundles.

Replacement Cost API

Material, labor, and lifecycle cost estimates per pole. Drives BEAD per-payer cost-causation splits.

Replacement Planning API

Portfolio-scale phased planning — group adjacent poles into projects, respect budget envelopes, prioritize the highest-value fixes.

Underground

Six standalone calculator APIs for underground distribution — vault, conduit, ampacity, fault current, and duct bank design.

Ampacity API

Preview

Neher-McGrath cable ampacity with soil, depth, and grouping corrections.

Fault Current API

Preview

ICEA cable fault withstand, concentric neutral duty, and IEEE 1584 arc flash.

Conduit Fill API

Preview

NEC Chapter 9 conduit fill % and three-cable jam detection (D/d 2.8–3.2).

Pulling Tension API

Preview

Cable pulling tension through bends with intermediate vault placement.

Duct Bank API

Preview

Layout optimization, multi-circuit derating, concrete encasement, trench dimensions.

Vault Sizing API

Preview

Catalog selection, NEC 110.34 working space, bending radius, padmount clearances.

Cross-utility analyzers

Five standalone services closing capability gaps that recur across utilities regardless of overhead/underground domain. Callable directly today; not yet on the conversational agent's tool surface.

Grounding API

IEEE 142 ground-rod resistance calculation and per-utility max-resistance compliance.

Avian Protection API

Raptor/avian protection zone screening and mitigation guidance.

Vegetation API

Clearance-driven vegetation-management rules and required right-of-way width.

Conductor Ampacity API

IEEE 738 steady-state thermal ampacity rating for overhead conductors.

Transformer Loading API

IEEE C57.91 hottest-spot temperature and thermal-loading check for pole-mounted transformers.