API and agents

Structured battery-compliance verdicts for your own workflow.

CertiWatt exposes the same cited verdict engine behind the public verifier: model resolution, trip-specific verdicts, rule discovery, and source evidence.

Verdict response shape

{
  "verdict": "conditional",
  "verdict_id": "cw_2026_05_example",
  "ruleset_version": "2026-05-16",
  "summary": "Carry-on only. Airline approval may be required.",
  "route_factors": [
    "Exact model capacity is evaluated against the active flight rules.",
    "Departure country overlays and airline policy are checked before the verdict."
  ],
  "article_body": "Carry-on only. Airline approval may be required.\n\nExact model capacity is evaluated against the active flight rules.\n\nDeparture country overlays and airline policy are checked before the verdict.\n\nCitation sources: CAAC (regulator, CN) https://...; Singapore Airlines (airline, SG) https://...",
  "conditions": ["carry_on_only", "max_2_units"],
  "citations": [
    { "kind": "regulator", "authority": "CAAC", "jurisdiction": "CN", "url": "https://...", "pulled_at": "2026-05-29" },
    { "kind": "airline", "authority": "Singapore Airlines", "jurisdiction": "SG", "url": "https://...", "pulled_at": "2026-05-29" }
  ]
}

Core fields

verdict: allowed, conditional, banned, or insufficient.
verdict_id: Stable audit handle for support and partner logs.
ruleset_version: The active rule corpus used for the answer.
citations: Primary source links for regulator, airline, manufacturer, or recall evidence.
conditions: Carry-on, approval, quantity, label, certification, or recall constraints.

Access paths

Public verifier API

The current web verifier calls /api/verify. Partner access, keys, rate limits, and caching terms are handled by agreement.

MCP package

Agents can run the published MCP package locally over stdio and call the live CertiWatt API.

MCP package

Embeds and pilots

For hosted widgets or pilot integrations, start through the partner page.

Embeds and pilots

Agent discovery

Answer engines and agents can read the AEO manifest for CertiWatt’s curated 2026 question guides, brand hubs, and long-tail verdict pages. The top level includes manifest_version, content_hash, ruleset_version, cache_policy, and counts, and the response exposes X-CertiWatt-Content-Hash plus a quoted ETag with the same hash. The manifest response also links its schema with rel="describedby"; the schema response exposes X-CertiWatt-Schema-Hash plus a quoted schema ETag. Each question guide entry includes short_answer, source_count, and sources with absolute citation URLs; each brand_hubs entry includes model counts and representative_models for brand-level catalog discovery; each long_tail_verdicts entry includes verdict, summary, route_factors, article_body, ruleset_version, citation_count, and sources. Programmatic verdict pages also expose Article JSON-LD articleBody with the verdict summary, route-specific signals, and citation source metadata: authority, kind, jurisdiction, URL, citation_kind, citation_jurisdiction, and pulled_at. The manifest is guarded for direct agent consumption: /aeo-manifest.json stays under 512KB, schema under 64KB, and each long-tail article_body under 1600 characters.

AEO manifest Manifest schema

Boundary

API outputs are cited informational verdicts. They must not be presented as legal advice, official certification, or guaranteed acceptance by airport, airline, or security staff.