Open API v1 — roadmap
Partners will eventually call Parity for shaped demand and honest coverage/health data. This demo ships a static OpenAPI 3 document and this page only — machine endpoints below return nothing live (documented as unimplemented-stub).
Spec version 0.2.0-local+stub · 2 stub paths documented
Demo honesty
No partner API keys are issued. No auth server. Hitting stub paths outside this documentation surface is undefined — use the UI today (shop, agent inbox, health hub). See trust, privacy, and security.
Future endpoints (stubs)
Quotes search
GET /api/v1/quotes/search
Filter illustrative marketplace quotes by ZIP and line with parity context. Will never rank by placement fee while hiding exposure regressions.
Intents
GET|POST /api/v1/intents
Agent-facing anonymized, quality-scored opt-in intents — ZIP, line, timeline — not dialer spam. Create only with consumer consent.
Health transparency
GET /api/v1/health/transparency
Facility / procedure price points with mandatory filed vs modeled provenance. Live MRF ingest is a milestone — not claimed in this demo.
Toward a real API
- Origin — hosted product URL and env before partner traffic.
- Auth + keys — consumer-controlled sync; partner API keys with rate limits (scheme reserved in OpenAPI as
X-Parity-Key). - Licensed agents — verification so intent routing leaves onboarding stubs.
- Live MRF — labeled filed ingest; never fake live hospital rates.
Full executive snapshot: see PRODUCT_STATUS.md in the repo.
Educational demo — not insurance advice · Not a production partner API