Docs

API reference

The full route-by-route reference is generated directly from the live gateway — every request/response shape you see there is the real, current contract, not documentation that can drift out of sync with it.

Interactive API reference

Every route, every domain, try-it-now request forms.

→

OpenAPI schema

Raw openapi.json — generate your own client for any language.

→

Both links point at the full gateway, which also serves the roadmap domains listed on/domains — routes are tagged by domain, so filter to overhead in the interactive docs for just what's live today.

Quickstart

Every route takes a typed request body and returns a typed, cited result — here's the real request/response shape for one function, /overhead/determine_nesc_grade:

Request
curl -X POST https://vertical-ai-api-593424780294.us-central1.run.app/overhead/determine_nesc_grade \
  -H "Authorization: Bearer vaico_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "inp": {
      "max_supply_voltage_v": 14400,
      "crosses_railroad": true,
      "auto_deenergized_at_crossing": false
    },
    "source_ref": "job-4471"
  }'
Response
{
  "grade": "B",
  "rationale": "Supply >22kV crossing a railroad without automatic de-energization requires Grade B.",
  "rule_refs": ["NESC Rule 242", "NESC Table 242-1"],
  "provenance": {
    "method": "determine_nesc_grade",
    "source_ref": "job-4471",
    "engine_version": "0.8.0",
    "computed_at": "2026-08-24T19:00:00Z",
    "notes": []
  }
}

Function reference

All 37 Overhead functions, path-by-path with request/response shapes — every path is relative to https://vertical-ai-api-593424780294.us-central1.run.app/overhead.

Available to signed-in customers

The full function-by-function reference is gated to accounts with an active key for this domain. Already a customer? Sign in below. Otherwise, request access and we'll get you a key.

Sign inRequest access

Authentication

Every request needs your key, either as a query param or a bearer token:

# Authorization header (recommended)
curl -H "Authorization: Bearer vaico_live_..." \
  https://vertical-ai-api-593424780294.us-central1.run.app/overhead/determine_nesc_grade

# or query param
curl "https://vertical-ai-api-593424780294.us-central1.run.app/overhead/determine_nesc_grade?key=vaico_live_..."

Scoping

Your key is scoped to exactly the domains (and, for Overhead, jurisdictions) on your plan. A route outside your key's scope returns 403, not a silent partial result — see pricing for what each plan grants.