FOR AGENTS, CI BOTS, AND HUMANS WITH A TERMINAL
The Assurance API
42 routes over CRA Article 14 and Machinery Regulation Annex III evidence. Bearer auth via one header, JSON in and out, and a real OpenAPI 3 schema you can fetch instead of trusting this page.
No live base URL yetThis marketing site was built without NEXT_PUBLIC_ASSURANCE_API_URL set. The routes, auth model, and examples below are real — read straight from the code — but there is nothing to call until the founder finishes deploy/assurance/README.md. Run it yourself: uvicorn assurance.api.service:app.
Auth
One header. Bearer token, never a cookie.
Send X-API-Key: <your key>. Get a key from POST /v1/checkout (Register or Cell) or by running the service locally with ASSURANCE_ALLOW_UNAUTHENTICATED=1 for evaluation. A missing key is a 401. A valid key on the wrong plan is a 402, never a 403 — the obstacle is payment, not permission, and every gated route says exactly which plan unlocks it.
Free, no key needed
curl -X POST https://<your-deployment>/v1/spec/validate \
-H 'content-type: application/json' \
-d '{"track":"actively_exploited_vulnerability","stage":"early_warning","payload":{}}'Routes
Free vs. paid, straight from the routers
Every row below is gated in code, in src/assurance/api/deps.py — if it is not gated, it is free. This is a curated view of the 42 routes; the full machine-readable schema (parameters, response shapes, every route including account/billing) is at /openapi.json.
| Method | Route | Plan | What it does |
|---|---|---|---|
GET | /v1/spec/fields | Validator — free | The platform field specification for a track/stage |
POST | /v1/spec/validate | Validator — free | Validate a draft submission without recording it |
GET | /v1/plans | Validator — free | What is on sale — this table, live |
POST | /v1/machine/separation | Validator — free | ISO/TS 15066 protective separation distance |
POST | /v1/machine/bundle/check | Validator — free | Re-verify someone else's evidence bundle |
POST | /v1/machinery/diff | Validator — free | Is the machine still the configuration you signed off? |
POST | /v1/machinery/passport/check | Validator — free | Re-verify someone else's machine passport |
POST | /v1/fleet/advisory/check | Validator — free | Is this one machine affected by this advisory? |
POST | /v1/fleet/declaration/check | Validator — free | Does this declaration still describe the machine? |
POST | /v1/check/machine | Validator — free | Machine Assurance Check — one manifest, one advisory, no account |
GET | /v1/ledger/attest/key | Validator — free | The public key this service counter-signs with |
POST | /v1/ledger/attest/verify | Validator — free | Check an attestation log |
GET | /v1/supplier/feed/{id} | Validator — free | Read a hosted supplier advisory feed |
GET | /v1/register | Register — €390/mo | The Article 14 register for your account |
GET | /v1/register/breaches | Register — €390/mo | Cases past a deadline clock |
GET | /v1/cases | Register — €390/mo | List cases |
GET | /v1/cases/{id}/export | Register — €390/mo | A verifiable evidence bundle for one case |
POST | /v1/cases/{id}/triage | Register — €390/mo | Record a triage decision |
POST | /v1/cases/{id}/filings | Register — €390/mo | Record a platform filing |
GET | /v1/ledger/verify | Register — €390/mo | Verify the hash chain |
POST | /v1/machine/verify | Cell — €1,290/mo | Verify a recorded machine run against its declared envelope |
POST | /v1/machinery/manifest | Cell — €1,290/mo | Seal a safety software manifest |
POST | /v1/machinery/intervention | Cell — €1,290/mo | Seal an intervention record |
POST | /v1/machinery/coverage | Cell — €1,290/mo | Which safety functions still have valid evidence |
POST | /v1/machinery/passport | Cell — €1,290/mo | Seal the machine's evidence position |
GET | /v1/fleet/machines | Cell — €1,290/mo | Every enrolled machine, worst coverage first |
GET | /v1/fleet/report | Cell — €1,290/mo | The whole fleet on one page a plant manager can read |
POST | /v1/fleet/advisory | Cell — €1,290/mo | Fan an advisory out across the whole fleet |
POST | /v1/check/fleet-machine | Cell — €1,290/mo | Machine Assurance Check — an enrolled machine, its ledger history and the fleet fan-out |
POST | /v1/fleet/declare | Cell — €1,290/mo | Bind a Declaration of Conformity to a configuration |
POST | /v1/ledger/attest | Cell — €1,290/mo | Counter-sign the head of your ledger |
GET | /v1/ledger/attest/log | Cell — €1,290/mo | Every attestation for your account |
POST | /v1/change/assess/drift | Cell — €1,290/mo | Turn a manifest divergence (baseline vs observed) into a change-assurance case |
POST | /v1/change/assess/advisory | Cell — €1,290/mo | Turn a fleet impact report for one advisory into a change-assurance case |
GET | /v1/change/cases | Cell — €1,290/mo | The Active Assurance Cases queue (optional ?status=) |
GET | /v1/change/cases/{case_id} | Cell — €1,290/mo | One change-assurance case in full |
POST | /v1/change/cases/{case_id}/claim | Cell — €1,290/mo | OPEN -> IN_REVIEW; body {owner, actor?} |
POST | /v1/change/cases/{case_id}/advance | Cell — €1,290/mo | Move to the next required stop; body {actor?} |
POST | /v1/change/cases/{case_id}/reverification | Cell — €1,290/mo | Supply fresh verification evidence; body {manifest, verification_content_hash, actor?} |
POST | /v1/change/cases/{case_id}/decision | Cell — €1,290/mo | Close, reject or defer — a named human decision; body {disposition, reason, actor?} |
POST | /v1/watch/report | Cell — €1,290/mo | Report what your own Watch saw (manifests and observation status) to your ledger — opt-in, idempotent |
GET | /v1/fleet/observations | Cell — €1,290/mo | Per machine: last successful observation, last attempt, stale, open cases |
POST | /v1/supplier/advisory | Supplier — contact sales | Publish a signed advisory to your hosted feed |
A paid route, called correctly
What a 402 looks like — and what success looks like
POST /v1/machine/verify needs the Cell plan. Called with a Register-only key, it fails closed with a structured upgrade hint instead of a bare 403 — an agent can parse this and route a human to checkout automatically.
Python
import httpx
resp = httpx.post(
"https://<your-deployment>/v1/machine/verify",
headers={"X-API-Key": api_key},
json={"envelope": envelope, "trace": trace, "actor": "you@example.com"},
)
if resp.status_code == 402:
detail = resp.json()["detail"]
# {"error": "plan_does_not_include_machine_verification",
# "tier": "register", "account_status": "active",
# "remedy": "...GET /v1/plans, then POST /v1/checkout."}
print(detail["remedy"])
else:
resp.raise_for_status()
print(resp.json())Wire an agent to this instead of reading it
Cursor, Claude, and CI bots discover this the same way: llms.txt, openapi.json, and this page.